ai-ask 1.0.1

package/dist/cli/repl.js

@@ -0,0 +1,166 @@
+import clipboardy from "clipboardy";
+import readline from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+import { formatExplanationOnly, formatReplHelp, formatSuggestion } from "../core/output.js";
+import { InMemorySession } from "../core/session.js";
+import { generateCommand } from "../core/generateCommand.js";
+import { assessCommandRisk } from "../safety/classifyRisk.js";
+import { enforceExecutionPolicy } from "../safety/executionPolicy.js";
+import { runCommand } from "../exec/runCommand.js";
+import { ClipboardError, ExecutionPolicyError, UserCancelledError, getErrorMessage } from "../utils/errors.js";
+import { formatReplBanner } from "../utils/branding.js";
+function resolveReplCommand(inputValue) {
+    const normalized = inputValue.trim().toLowerCase();
+    if (normalized === "help") {
+        return "help";
+    }
+    if (normalized === "last") {
+        return "last";
+    }
+    if (normalized.startsWith("explain")) {
+        return "explain";
+    }
+    if (normalized.startsWith("run")) {
+        return "run";
+    }
+    if (normalized === "copy") {
+        return "copy";
+    }
+    if (normalized === "clear") {
+        return "clear";
+    }
+    if (normalized === "exit" || normalized === "quit") {
+        return "exit";
+    }
+    return undefined;
+}
+async function copyCommand(command) {
+    try {
+        await clipboardy.write(command);
+    }
+    catch (error) {
+        throw new ClipboardError("Clipboard unavailable. Command printed below instead.", error);
+    }
+}
+export async function startRepl(options) {
+    const session = new InMemorySession();
+    const rl = readline.createInterface({ input, output, terminal: true });
+    const handleSigint = () => {
+        output.write("\n");
+        rl.close();
+    };
+    process.once("SIGINT", handleSigint);
+    try {
+        output.write(`${formatReplBanner()}\nInteractive mode. Type help for commands.\n`);
+        while (true) {
+            let line;
+            try {
+                line = await rl.question("ai-cmd > ");
+            }
+            catch {
+                break;
+            }
+            const inputValue = line.trim();
+            if (inputValue.length === 0) {
+                continue;
+            }
+            const replCommand = resolveReplCommand(inputValue);
+            const lastSuggestion = session.getLastSuggestion();
+            if (replCommand === "exit") {
+                break;
+            }
+            if (replCommand === "help") {
+                output.write(`${formatReplHelp(options.color)}\n`);
+                continue;
+            }
+            try {
+                if (replCommand === "clear") {
+                    session.clear();
+                    output.write("Session cleared.\n");
+                    continue;
+                }
+                if (replCommand && !lastSuggestion) {
+                    output.write("No command in session yet. Ask a question first.\n");
+                    continue;
+                }
+                if (replCommand === "last" && lastSuggestion) {
+                    output.write(`${formatSuggestion(lastSuggestion, {
+                        color: options.color,
+                        explain: true,
+                        json: false
+                    })}\n`);
+                    continue;
+                }
+                if (replCommand === "explain" && lastSuggestion) {
+                    output.write(`${formatExplanationOnly(lastSuggestion, options.color)}\n`);
+                    continue;
+                }
+                if (replCommand === "copy" && lastSuggestion) {
+                    try {
+                        await copyCommand(lastSuggestion.command);
+                        output.write("Command copied to clipboard.\n");
+                    }
+                    catch (error) {
+                        if (error instanceof ClipboardError) {
+                            output.write(`${error.message}\n${lastSuggestion.command}\n`);
+                            continue;
+                        }
+                        throw error;
+                    }
+                    continue;
+                }
+                if (replCommand === "run" && lastSuggestion) {
+                    if (options.platform.os === "unsupported") {
+                        output.write("Execution is disabled on unsupported host OSes. Use a Unix-like shell or WSL.\n");
+                        continue;
+                    }
+                    const assessment = assessCommandRisk(lastSuggestion.command);
+                    output.write(`${formatSuggestion(lastSuggestion, {
+                        color: options.color,
+                        explain: true,
+                        json: false
+                    })}\n`);
+                    await enforceExecutionPolicy({
+                        command: lastSuggestion.command,
+                        risk: assessment.level,
+                        yes: false,
+                        prompt: options.prompt,
+                        ...(assessment.reasons[0] ? { reason: assessment.reasons[0] } : {})
+                    });
+                    await runCommand(lastSuggestion.command, {
+                        cwd: options.platform.cwd,
+                        stdio: "inherit"
+                    });
+                    continue;
+                }
+                const suggestion = await generateCommand({
+                    question: inputValue,
+                    platform: options.platform,
+                    provider: options.provider,
+                    explainRequested: true,
+                    history: session.getHistory()
+                });
+                session.remember(inputValue, suggestion);
+                options.logger.debug("Generated command suggestion", suggestion);
+                output.write(`${formatSuggestion(suggestion, {
+                    color: options.color,
+                    explain: true,
+                    json: false
+                })}\n`);
+            }
+            catch (error) {
+                if (error instanceof UserCancelledError ||
+                    error instanceof ExecutionPolicyError) {
+                    output.write(`${error.message}\n`);
+                    continue;
+                }
+                output.write(`${getErrorMessage(error)}\n`);
+            }
+        }
+    }
+    finally {
+        process.removeListener("SIGINT", handleSigint);
+        rl.close();
+    }
+}
+//# sourceMappingURL=repl.js.map

package/dist/cli/repl.js.map

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

package/dist/config/env.d.ts

@@ -0,0 +1,2 @@
+export declare const DEFAULT_CONFIG_PATH: string;
+export declare function getEnvValue(env: NodeJS.ProcessEnv, key: string): string | undefined;

package/dist/config/env.js

@@ -0,0 +1,8 @@
+import { homedir } from "node:os";
+import path from "node:path";
+export const DEFAULT_CONFIG_PATH = path.join(homedir(), ".ai-cmd", "config.json");
+export function getEnvValue(env, key) {
+    const value = env[key];
+    return value && value.trim().length > 0 ? value.trim() : undefined;
+}
+//# sourceMappingURL=env.js.map

package/dist/config/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/config/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAC1C,OAAO,EAAE,EACT,SAAS,EACT,aAAa,CACd,CAAC;AAEF,MAAM,UAAU,WAAW,CACzB,GAAsB,EACtB,GAAW;IAEX,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,OAAO,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACrE,CAAC"}

package/dist/config/userConfig.d.ts

@@ -0,0 +1,10 @@
+import type { AppConfig } from "../types/index.js";
+export type LoadConfigOptions = {
+    env?: NodeJS.ProcessEnv;
+    configPath?: string;
+    readConfigFile?: (configPath: string) => Promise<string>;
+    ensureConfigScaffold?: (configPath: string) => Promise<void>;
+};
+export declare function ensureDefaultConfigScaffold(configPath: string): Promise<void>;
+export declare function loadUserConfig(configPath?: string, readConfigFile?: (configPath: string) => Promise<string>): Promise<Partial<AppConfig>>;
+export declare function loadConfig(options?: LoadConfigOptions): Promise<AppConfig>;

package/dist/config/userConfig.js

@@ -0,0 +1,91 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { z } from "zod";
+import { DEFAULT_CONFIG_PATH, getEnvValue } from "./env.js";
+import { ConfigurationError } from "../utils/errors.js";
+const partialConfigSchema = z.object({
+    provider: z.literal("openai").optional(),
+    model: z.string().min(1).optional(),
+    apiKey: z.string().min(1).optional(),
+    baseUrl: z.string().url().optional(),
+    timeoutMs: z.number().int().positive().optional()
+});
+const finalConfigSchema = z.object({
+    provider: z.literal("openai").default("openai"),
+    model: z.string().min(1).default("gpt-4.1-mini"),
+    apiKey: z.string().min(1),
+    baseUrl: z.string().url().default("https://api.openai.com/v1"),
+    timeoutMs: z.number().int().positive().default(30_000)
+});
+const DEFAULT_CONFIG_TEMPLATE = {
+    provider: "openai",
+    model: "gpt-5.4-mini",
+    apiKey: "your-api-key-here",
+    baseUrl: "https://api.openai.com/v1",
+    timeoutMs: 30_000
+};
+export async function ensureDefaultConfigScaffold(configPath) {
+    await mkdir(path.dirname(configPath), { recursive: true });
+    try {
+        await writeFile(configPath, `${JSON.stringify(DEFAULT_CONFIG_TEMPLATE, null, 2)}\n`, {
+            flag: "wx"
+        });
+    }
+    catch (error) {
+        if (error.code === "EEXIST") {
+            return;
+        }
+        throw new ConfigurationError(`Failed to create ${configPath}.`, error);
+    }
+}
+export async function loadUserConfig(configPath = DEFAULT_CONFIG_PATH, readConfigFile = (inputPath) => readFile(inputPath, "utf8")) {
+    try {
+        const rawConfig = await readConfigFile(configPath);
+        const parsed = JSON.parse(rawConfig);
+        const validated = partialConfigSchema.parse(parsed);
+        return {
+            ...(validated.provider ? { provider: validated.provider } : {}),
+            ...(validated.model ? { model: validated.model } : {}),
+            ...(validated.apiKey ? { apiKey: validated.apiKey } : {}),
+            ...(validated.baseUrl ? { baseUrl: validated.baseUrl } : {}),
+            ...(validated.timeoutMs ? { timeoutMs: validated.timeoutMs } : {})
+        };
+    }
+    catch (error) {
+        if (error?.code === "ENOENT") {
+            return {};
+        }
+        if (error instanceof SyntaxError) {
+            throw new ConfigurationError(`Failed to parse ${configPath}: invalid JSON.`, error);
+        }
+        if (error instanceof z.ZodError) {
+            throw new ConfigurationError(`Invalid configuration in ${configPath}.`, error.flatten());
+        }
+        throw new ConfigurationError(`Failed to read ${configPath}.`, error);
+    }
+}
+export async function loadConfig(options = {}) {
+    const env = options.env ?? process.env;
+    const configPath = options.configPath ?? DEFAULT_CONFIG_PATH;
+    const ensureConfigScaffold = options.ensureConfigScaffold ?? ensureDefaultConfigScaffold;
+    const fileConfig = await loadUserConfig(configPath, options.readConfigFile);
+    const merged = {
+        provider: getEnvValue(env, "AI_PROVIDER") ?? fileConfig.provider ?? "openai",
+        model: getEnvValue(env, "AI_MODEL") ?? fileConfig.model ?? "gpt-4.1-mini",
+        apiKey: getEnvValue(env, "AI_API_KEY") ?? fileConfig.apiKey,
+        baseUrl: getEnvValue(env, "AI_BASE_URL") ??
+            fileConfig.baseUrl ??
+            "https://api.openai.com/v1",
+        timeoutMs: Number.parseInt(getEnvValue(env, "AI_TIMEOUT_MS") ?? String(fileConfig.timeoutMs ?? 30_000), 10) || 30_000
+    };
+    const parsed = finalConfigSchema.safeParse(merged);
+    if (!parsed.success) {
+        if (!merged.apiKey) {
+            await ensureConfigScaffold(configPath);
+            throw new ConfigurationError(`Missing AI_API_KEY. Set it in your environment or edit ${configPath}. A starter config has been created if it did not already exist.`);
+        }
+        throw new ConfigurationError("Invalid AI configuration.", parsed.error.flatten());
+    }
+    return parsed.data;
+}
+//# sourceMappingURL=userConfig.js.map

package/dist/config/userConfig.js.map

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

package/dist/core/explainCommand.d.ts

@@ -0,0 +1,2 @@
+import type { CommandSuggestion } from "../types/index.js";
+export declare function explainCommand(suggestion: CommandSuggestion): string;

package/dist/core/explainCommand.js

@@ -0,0 +1,4 @@
+export function explainCommand(suggestion) {
+    return suggestion.explanation;
+}
+//# sourceMappingURL=explainCommand.js.map

package/dist/core/explainCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainCommand.js","sourceRoot":"","sources":["../../src/core/explainCommand.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,cAAc,CAAC,UAA6B;IAC1D,OAAO,UAAU,CAAC,WAAW,CAAC;AAChC,CAAC"}

package/dist/core/generateCommand.d.ts

@@ -0,0 +1,2 @@
+import type { CommandSuggestion, GenerateCommandOptions } from "../types/index.js";
+export declare function generateCommand(options: GenerateCommandOptions): Promise<CommandSuggestion>;

package/dist/core/generateCommand.js

@@ -0,0 +1,29 @@
+import { buildGenerateObjectRequest } from "./prompts.js";
+import { parseProviderPayload } from "./response.js";
+import { classifyRisk } from "../safety/classifyRisk.js";
+export async function generateCommand(options) {
+    const request = buildGenerateObjectRequest({
+        question: options.question,
+        platform: options.platform,
+        explainRequested: options.explainRequested ?? true,
+        history: options.history ?? []
+    });
+    const response = await options.provider.generateObject(request);
+    const payload = parseProviderPayload(response.rawText);
+    const platformNotes = [
+        ...(payload.platformNotes ?? []),
+        ...(options.platform.os === "unsupported"
+            ? ["Detected unsupported host OS; generated a best-effort Unix-style command."]
+            : [])
+    ];
+    return {
+        question: options.question,
+        command: payload.command,
+        explanation: payload.explanation,
+        risk: classifyRisk(payload.command),
+        platform: options.platform,
+        ...(platformNotes.length > 0 ? { platformNotes } : {}),
+        ...(payload.assumptions ? { assumptions: payload.assumptions } : {})
+    };
+}
+//# sourceMappingURL=generateCommand.js.map

package/dist/core/generateCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateCommand.js","sourceRoot":"","sources":["../../src/core/generateCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAMzD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAA+B;IAE/B,MAAM,OAAO,GAAG,0BAA0B,CAAC;QACzC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,IAAI;QAClD,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;KAC/B,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,oBAAoB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACvD,MAAM,aAAa,GAAG;QACpB,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;QAChC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,KAAK,aAAa;YACvC,CAAC,CAAC,CAAC,2EAA2E,CAAC;YAC/E,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;IAEF,OAAO;QACL,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC;QACnC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,GAAG,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrE,CAAC;AACJ,CAAC"}

package/dist/core/output.d.ts

@@ -0,0 +1,4 @@
+import type { CommandSuggestion, OutputOptions } from "../types/index.js";
+export declare function formatSuggestion(suggestion: CommandSuggestion, options: OutputOptions): string;
+export declare function formatExplanationOnly(suggestion: CommandSuggestion, color: boolean): string;
+export declare function formatReplHelp(color: boolean): string;

package/dist/core/output.js

@@ -0,0 +1,67 @@
+import { Chalk } from "chalk";
+function createPalette(color) {
+    return new Chalk({ level: color ? 1 : 0 });
+}
+function colorizeRisk(chalk, risk) {
+    if (risk === "high") {
+        return chalk.red(risk);
+    }
+    if (risk === "medium") {
+        return chalk.yellow(risk);
+    }
+    return chalk.green(risk);
+}
+export function formatSuggestion(suggestion, options) {
+    if (options.json) {
+        return JSON.stringify({
+            question: suggestion.question,
+            command: suggestion.command,
+            explanation: suggestion.explanation,
+            risk: suggestion.risk,
+            platformNotes: suggestion.platformNotes,
+            assumptions: suggestion.assumptions,
+            platform: suggestion.platform
+        }, null, 2);
+    }
+    const chalk = createPalette(options.color);
+    const lines = [
+        chalk.bold("Command"),
+        chalk.cyan(suggestion.command)
+    ];
+    if (options.explain) {
+        lines.push("", chalk.bold("Explanation"), suggestion.explanation, "");
+    }
+    else {
+        lines.push("");
+    }
+    lines.push(`${chalk.bold("Risk")} ${colorizeRisk(chalk, suggestion.risk)}`);
+    if (suggestion.assumptions && suggestion.assumptions.length > 0) {
+        lines.push("", chalk.bold("Assumptions"), ...suggestion.assumptions.map((item) => `- ${item}`));
+    }
+    if (suggestion.platformNotes && suggestion.platformNotes.length > 0) {
+        lines.push("", chalk.bold("Platform Notes"), ...suggestion.platformNotes.map((item) => `- ${item}`));
+    }
+    return lines.join("\n");
+}
+export function formatExplanationOnly(suggestion, color) {
+    const chalk = createPalette(color);
+    const lines = [chalk.bold("Explanation"), suggestion.explanation];
+    if (suggestion.assumptions && suggestion.assumptions.length > 0) {
+        lines.push("", chalk.bold("Assumptions"), ...suggestion.assumptions.map((item) => `- ${item}`));
+    }
+    return lines.join("\n");
+}
+export function formatReplHelp(color) {
+    const chalk = createPalette(color);
+    return [
+        chalk.bold("Commands"),
+        "help      Show this help",
+        "last      Show the last suggested command",
+        "explain   Show the explanation for the last command",
+        "run       Execute the last command with confirmation",
+        "copy      Copy the last command to the clipboard",
+        "clear     Clear session memory",
+        "exit      Leave ai-cmd"
+    ].join("\n");
+}
+//# sourceMappingURL=output.js.map

package/dist/core/output.js.map

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

package/dist/core/prompts.d.ts

@@ -0,0 +1,7 @@
+import type { ConversationTurn, GenerateObjectRequest, PlatformContext } from "../types/index.js";
+export declare function buildGenerateObjectRequest(options: {
+    question: string;
+    platform: PlatformContext;
+    explainRequested: boolean;
+    history: ConversationTurn[];
+}): GenerateObjectRequest;

package/dist/core/prompts.js

@@ -0,0 +1,71 @@
+export function buildGenerateObjectRequest(options) {
+    const schema = {
+        type: "object",
+        additionalProperties: false,
+        required: ["command", "explanation"],
+        properties: {
+            command: {
+                type: "string",
+                description: "Exactly one best shell command on a single line. Use operators like && only when required."
+            },
+            explanation: {
+                type: "string",
+                description: "A short practical explanation of what the command does."
+            },
+            platformNotes: {
+                type: "array",
+                items: { type: "string" }
+            },
+            assumptions: {
+                type: "array",
+                items: { type: "string" }
+            }
+        }
+    };
+    const systemPrompt = [
+        "You are ai-cmd, a shell command assistant for Unix-like environments.",
+        "Return exactly one best command for the user's current environment.",
+        "Prefer standard native tools over obscure alternatives.",
+        "Do not invent commands, package names, or service names.",
+        "Tailor the command to the detected OS, shell, and service manager.",
+        "If the environment is uncertain, make the safest reasonable assumption and state it in assumptions.",
+        "Keep explanations concise and practical.",
+        "Return valid JSON only. Do not include markdown fences or prose outside the JSON object."
+    ].join(" ");
+    const historyBlock = options.history.length === 0
+        ? "No previous conversation context."
+        : JSON.stringify(options.history.slice(-4), null, 2);
+    const userPrompt = [
+        "Environment context:",
+        JSON.stringify({
+            os: options.platform.os,
+            shell: options.platform.shell,
+            serviceManager: options.platform.serviceManager,
+            cwdName: options.platform.cwdName
+        }, null, 2),
+        "",
+        "Conversation context:",
+        historyBlock,
+        "",
+        `Explain output requested: ${options.explainRequested ? "yes" : "no"}`,
+        `User question: ${options.question}`,
+        "",
+        "Response schema:",
+        JSON.stringify(schema, null, 2),
+        "",
+        "Rules:",
+        "- command must be a single string on one line",
+        "- do not return multiple alternatives",
+        "- use assumptions only when needed",
+        "- use platformNotes for short platform-specific caveats"
+    ].join("\n");
+    return {
+        systemPrompt,
+        userPrompt,
+        schemaName: "command_suggestion",
+        schemaDescription: "A single shell command suggestion for the current environment.",
+        jsonSchema: schema,
+        temperature: 0.1
+    };
+}
+//# sourceMappingURL=prompts.js.map

package/dist/core/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/core/prompts.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,0BAA0B,CAAC,OAK1C;IACC,MAAM,MAAM,GAAG;QACb,IAAI,EAAE,QAAQ;QACd,oBAAoB,EAAE,KAAK;QAC3B,QAAQ,EAAE,CAAC,SAAS,EAAE,aAAa,CAAC;QACpC,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,4FAA4F;aAC/F;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yDAAyD;aACvE;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC1B;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC1B;SACF;KACgC,CAAC;IAEpC,MAAM,YAAY,GAAG;QACnB,uEAAuE;QACvE,qEAAqE;QACrE,yDAAyD;QACzD,0DAA0D;QAC1D,oEAAoE;QACpE,qGAAqG;QACrG,0CAA0C;QAC1C,0FAA0F;KAC3F,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEZ,MAAM,YAAY,GAChB,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAC1B,CAAC,CAAC,mCAAmC;QACrC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAEzD,MAAM,UAAU,GAAG;QACjB,sBAAsB;QACtB,IAAI,CAAC,SAAS,CACZ;YACE,EAAE,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE;YACvB,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK;YAC7B,cAAc,EAAE,OAAO,CAAC,QAAQ,CAAC,cAAc;YAC/C,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,OAAO;SAClC,EACD,IAAI,EACJ,CAAC,CACF;QACD,EAAE;QACF,uBAAuB;QACvB,YAAY;QACZ,EAAE;QACF,6BAA6B,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;QACtE,kBAAkB,OAAO,CAAC,QAAQ,EAAE;QACpC,EAAE;QACF,kBAAkB;QAClB,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/B,EAAE;QACF,QAAQ;QACR,+CAA+C;QAC/C,uCAAuC;QACvC,oCAAoC;QACpC,yDAAyD;KAC1D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,OAAO;QACL,YAAY;QACZ,UAAU;QACV,UAAU,EAAE,oBAAoB;QAChC,iBAAiB,EAAE,gEAAgE;QACnF,UAAU,EAAE,MAAM;QAClB,WAAW,EAAE,GAAG;KACjB,CAAC;AACJ,CAAC"}

package/dist/core/response.d.ts

@@ -0,0 +1,19 @@
+import { z } from "zod";
+import type { ProviderCommandPayload } from "../types/index.js";
+export declare const providerCommandSchema: z.ZodObject<{
+    command: z.ZodString;
+    explanation: z.ZodString;
+    platformNotes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    assumptions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    command: string;
+    explanation: string;
+    platformNotes?: string[] | undefined;
+    assumptions?: string[] | undefined;
+}, {
+    command: string;
+    explanation: string;
+    platformNotes?: string[] | undefined;
+    assumptions?: string[] | undefined;
+}>;
+export declare function parseProviderPayload(rawText: string): ProviderCommandPayload;

package/dist/core/response.js

@@ -0,0 +1,44 @@
+import { jsonrepair } from "jsonrepair";
+import { z } from "zod";
+import { extractFirstJsonObject, hasMultipleCommandLines, normalizeOptionalList, normalizeText, stripMarkdownCodeFence } from "../utils/strings.js";
+import { ResponseValidationError } from "../utils/errors.js";
+export const providerCommandSchema = z.object({
+    command: z.string().min(1),
+    explanation: z.string().min(1),
+    platformNotes: z.array(z.string().min(1)).optional(),
+    assumptions: z.array(z.string().min(1)).optional()
+});
+function parseJson(rawText) {
+    const stripped = stripMarkdownCodeFence(rawText);
+    const candidate = extractFirstJsonObject(stripped);
+    try {
+        return JSON.parse(candidate);
+    }
+    catch {
+        try {
+            return JSON.parse(jsonrepair(candidate));
+        }
+        catch (error) {
+            throw new ResponseValidationError("Failed to generate command: provider returned invalid JSON.", error);
+        }
+    }
+}
+export function parseProviderPayload(rawText) {
+    const parsed = providerCommandSchema.safeParse(parseJson(rawText));
+    if (!parsed.success) {
+        throw new ResponseValidationError("Failed to generate command: provider response did not match the expected schema.", parsed.error.flatten());
+    }
+    const platformNotes = normalizeOptionalList(parsed.data.platformNotes);
+    const assumptions = normalizeOptionalList(parsed.data.assumptions);
+    const payload = {
+        command: parsed.data.command.trim(),
+        explanation: normalizeText(parsed.data.explanation),
+        ...(platformNotes ? { platformNotes } : {}),
+        ...(assumptions ? { assumptions } : {})
+    };
+    if (hasMultipleCommandLines(payload.command)) {
+        throw new ResponseValidationError("Failed to generate command: provider returned multiple commands instead of one.");
+    }
+    return payload;
+}
+//# sourceMappingURL=response.js.map

package/dist/core/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../../src/core/response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,aAAa,EACb,sBAAsB,EACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACpD,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACnD,CAAC,CAAC;AAEH,SAAS,SAAS,CAAC,OAAe;IAChC,MAAM,QAAQ,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAEnD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAY,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,CAAY,CAAC;QACtD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,uBAAuB,CAC/B,6DAA6D,EAC7D,KAAK,CACN,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAEnE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,uBAAuB,CAC/B,kFAAkF,EAClF,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CACvB,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,qBAAqB,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACvE,MAAM,WAAW,GAAG,qBAAqB,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAEnE,MAAM,OAAO,GAAG;QACd,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE;QACnC,WAAW,EAAE,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;QACnD,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3C,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACP,CAAC;IAEnC,IAAI,uBAAuB,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,uBAAuB,CAC/B,iFAAiF,CAClF,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/core/session.d.ts

@@ -0,0 +1,9 @@
+import type { CommandSuggestion, ConversationTurn } from "../types/index.js";
+export declare class InMemorySession {
+    private history;
+    private lastSuggestion;
+    remember(question: string, suggestion: CommandSuggestion): void;
+    getHistory(limit?: number): ConversationTurn[];
+    getLastSuggestion(): CommandSuggestion | undefined;
+    clear(): void;
+}

package/dist/core/session.js

@@ -0,0 +1,23 @@
+export class InMemorySession {
+    history = [];
+    lastSuggestion;
+    remember(question, suggestion) {
+        this.lastSuggestion = suggestion;
+        this.history.push({
+            question,
+            command: suggestion.command,
+            explanation: suggestion.explanation
+        });
+    }
+    getHistory(limit = 4) {
+        return this.history.slice(-limit);
+    }
+    getLastSuggestion() {
+        return this.lastSuggestion;
+    }
+    clear() {
+        this.history = [];
+        this.lastSuggestion = undefined;
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/core/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/core/session.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,eAAe;IAClB,OAAO,GAAuB,EAAE,CAAC;IACjC,cAAc,CAAgC;IAE/C,QAAQ,CAAC,QAAgB,EAAE,UAA6B;QAC7D,IAAI,CAAC,cAAc,GAAG,UAAU,CAAC;QACjC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;YAChB,QAAQ;YACR,OAAO,EAAE,UAAU,CAAC,OAAO;YAC3B,WAAW,EAAE,UAAU,CAAC,WAAW;SACpC,CAAC,CAAC;IACL,CAAC;IAEM,UAAU,CAAC,KAAK,GAAG,CAAC;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAEM,iBAAiB;QACtB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAEM,KAAK;QACV,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;IAClC,CAAC;CACF"}