openshell-ai 1.0.4

package/dist/config/configurator.js

@@ -0,0 +1,133 @@
+import { randomUUID } from "node:crypto";
+import prompts from "prompts";
+import { DEFAULT_CONFIG_PATH } from "./env.js";
+import { providerDefaults } from "./providerCatalog.js";
+import { configFileExists, ensureDefaultConfigScaffold, loadConfig, saveUserConfig } from "./userConfig.js";
+import { ConfigurationError, UserCancelledError } from "../utils/errors.js";
+export function createConfiguratorPromptAdapter() {
+    const onCancel = () => {
+        throw new UserCancelledError("Configuration cancelled.");
+    };
+    return {
+        async select(message, choices) {
+            const response = await prompts({
+                type: "select",
+                name: "value",
+                message,
+                choices
+            }, { onCancel });
+            return response.value;
+        },
+        async text(message, initial = "") {
+            const response = await prompts({
+                type: "text",
+                name: "value",
+                message,
+                initial
+            }, { onCancel });
+            return String(response.value ?? "").trim();
+        },
+        async password(message) {
+            const response = await prompts({
+                type: "password",
+                name: "value",
+                message
+            }, { onCancel });
+            return String(response.value ?? "").trim();
+        },
+        async confirm(message, initial = false) {
+            const response = await prompts({
+                type: "confirm",
+                name: "value",
+                message,
+                initial
+            }, { onCancel });
+            return Boolean(response.value);
+        }
+    };
+}
+async function promptForRequiredText(options) {
+    const value = await options.prompt.text(options.message, options.initial);
+    if (value.length === 0) {
+        throw new ConfigurationError(options.errorMessage);
+    }
+    return value;
+}
+function ensureValidUrl(value, providerLabel) {
+    try {
+        return new URL(value).toString().replace(/\/$/u, "");
+    }
+    catch (error) {
+        throw new ConfigurationError(`${providerLabel} base URL must be a valid URL.`, error);
+    }
+}
+export async function runConfigurator(options = {}) {
+    const configPath = options.configPath ?? DEFAULT_CONFIG_PATH;
+    const prompt = options.prompt ?? createConfiguratorPromptAdapter();
+    const saveConfig = options.saveConfig ?? saveUserConfig;
+    const provider = await prompt.select("AI Provider", [
+        { title: "OpenAI", value: "openai" },
+        { title: "Anthropic", value: "anthropic" },
+        { title: "Ollama", value: "ollama" },
+        { title: "Google", value: "google" },
+        { title: "vLLM", value: "vllm" }
+    ]);
+    const providerConfig = providerDefaults[provider];
+    const apiKey = providerConfig.requiresApiKey
+        ? await prompt.password(`API Key for ${providerConfig.label}`)
+        : await prompt.text(`API Key for ${providerConfig.label} (optional)`);
+    const model = await promptForRequiredText({
+        prompt,
+        message: `Model for ${providerConfig.label}`,
+        initial: providerConfig.model,
+        errorMessage: `${providerConfig.label} requires a model name.`
+    });
+    const baseUrl = ensureValidUrl(await promptForRequiredText({
+        prompt,
+        message: `Base URL for ${providerConfig.label}`,
+        initial: providerConfig.baseUrl,
+        errorMessage: `${providerConfig.label} requires a base URL.`
+    }), providerConfig.label);
+    if (providerConfig.requiresApiKey && apiKey.length === 0) {
+        throw new ConfigurationError(`${providerConfig.label} requires an API key.`);
+    }
+    const analytics = await prompt.confirm([
+        "Help improve ai-cmd 🚀",
+        "Allow anonymous usage analytics?",
+        "- No personal data",
+        "- No command content stored",
+        "- Error reports may include the prompt that caused a failure",
+        "",
+        "(y/n) (default is no)"
+    ].join("\n"), false);
+    const config = {
+        provider,
+        model,
+        baseUrl,
+        timeoutMs: 30_000,
+        analytics,
+        ...(apiKey ? { apiKey } : {}),
+        ...(analytics ? { analyticsId: randomUUID() } : {})
+    };
+    await saveConfig(config, configPath);
+    process.stdout.write(`Configurator saved ${configPath}.\n`);
+    return config;
+}
+export async function loadOrConfigureConfig(options = {}) {
+    const configPath = options.configPath ?? DEFAULT_CONFIG_PATH;
+    if (await configFileExists(configPath)) {
+        return loadConfig({ configPath });
+    }
+    try {
+        return await loadConfig({ configPath });
+    }
+    catch (error) {
+        if (!process.stdin.isTTY || !process.stdout.isTTY) {
+            await ensureDefaultConfigScaffold(configPath);
+            throw new ConfigurationError(`No config found and the interactive configurator is unavailable in this shell. Edit ${configPath} or set AI_PROVIDER and AI_API_KEY in your environment.`, error);
+        }
+        await runConfigurator(options);
+        return loadConfig({ configPath });
+    }
+}
+//# sourceMappingURL=configurator.js.map

package/dist/config/configurator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configurator.js","sourceRoot":"","sources":["../../src/config/configurator.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/providerCatalog.d.ts

@@ -0,0 +1,8 @@
+import type { ProviderName } from "../types/index.js";
+export interface ProviderDefinition {
+    label: string;
+    model: string;
+    baseUrl: string;
+    requiresApiKey: boolean;
+}
+export declare const providerDefaults: Record<ProviderName, ProviderDefinition>;

package/dist/config/providerCatalog.js

@@ -0,0 +1,33 @@
+export const providerDefaults = {
+    openai: {
+        label: "OpenAI",
+        model: "gpt-5.4-mini",
+        baseUrl: "https://api.openai.com/v1",
+        requiresApiKey: true
+    },
+    anthropic: {
+        label: "Anthropic",
+        model: "claude-sonnet-4-20250514",
+        baseUrl: "https://api.anthropic.com/v1",
+        requiresApiKey: true
+    },
+    ollama: {
+        label: "Ollama",
+        model: "gemma3:4b",
+        baseUrl: "http://localhost:11434/api",
+        requiresApiKey: false
+    },
+    google: {
+        label: "Google",
+        model: "gemini-2.5-flash",
+        baseUrl: "https://generativelanguage.googleapis.com/v1beta",
+        requiresApiKey: true
+    },
+    vllm: {
+        label: "vLLM",
+        model: "google/gemma-3-4b-it",
+        baseUrl: "http://localhost:8000/v1",
+        requiresApiKey: false
+    }
+};
+//# sourceMappingURL=providerCatalog.js.map

package/dist/config/providerCatalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providerCatalog.js","sourceRoot":"","sources":["../../src/config/providerCatalog.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,gBAAgB,GAA6C;IACxE,MAAM,EAAE;QACN,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,cAAc;QACrB,OAAO,EAAE,2BAA2B;QACpC,cAAc,EAAE,IAAI;KACrB;IACD,SAAS,EAAE;QACT,KAAK,EAAE,WAAW;QAClB,KAAK,EAAE,0BAA0B;QACjC,OAAO,EAAE,8BAA8B;QACvC,cAAc,EAAE,IAAI;KACrB;IACD,MAAM,EAAE;QACN,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,WAAW;QAClB,OAAO,EAAE,4BAA4B;QACrC,cAAc,EAAE,KAAK;KACtB;IACD,MAAM,EAAE;QACN,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,kBAAkB;QACzB,OAAO,EAAE,kDAAkD;QAC3D,cAAc,EAAE,IAAI;KACrB;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,sBAAsB;QAC7B,OAAO,EAAE,0BAA0B;QACnC,cAAc,EAAE,KAAK;KACtB;CACF,CAAC"}

package/dist/config/userConfig.d.ts

@@ -0,0 +1,12 @@
+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 configFileExists(configPath?: string): Promise<boolean>;
+export declare function saveUserConfig(config: AppConfig, 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,141 @@
+import { access, 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 { providerDefaults } from "./providerCatalog.js";
+import { ConfigurationError } from "../utils/errors.js";
+const providerSchema = z.enum([
+    "openai",
+    "anthropic",
+    "ollama",
+    "google",
+    "vllm"
+]);
+const partialConfigSchema = z.object({
+    provider: providerSchema.optional(),
+    model: z.string().min(1).optional(),
+    apiKey: z.string().min(1).optional(),
+    baseUrl: z.string().url().optional(),
+    timeoutMs: z.number().int().positive().optional(),
+    analytics: z.boolean().optional(),
+    analyticsId: z.string().uuid().optional()
+});
+const finalConfigSchema = z.object({
+    provider: providerSchema,
+    model: z.string().min(1),
+    apiKey: z.string().min(1).optional(),
+    baseUrl: z.string().url(),
+    timeoutMs: z.number().int().positive(),
+    analytics: z.boolean(),
+    analyticsId: z.string().uuid().optional()
+});
+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,
+    analytics: false
+};
+export async function configFileExists(configPath = DEFAULT_CONFIG_PATH) {
+    try {
+        await access(configPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function saveUserConfig(config, configPath = DEFAULT_CONFIG_PATH) {
+    await mkdir(path.dirname(configPath), { recursive: true });
+    await writeFile(`${configPath}`, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+}
+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 } : {}),
+            analytics: validated.analytics ?? false,
+            ...(validated.analyticsId ? { analyticsId: validated.analyticsId } : {})
+        };
+    }
+    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 rawProvider = getEnvValue(env, "AI_PROVIDER") ?? fileConfig.provider ?? "openai";
+    const providerResult = providerSchema.safeParse(rawProvider);
+    if (!providerResult.success) {
+        throw new ConfigurationError("Invalid AI provider. Supported providers: openai, anthropic, ollama, google, vllm.", providerResult.error.flatten());
+    }
+    const provider = providerResult.data;
+    const defaults = providerDefaults[provider];
+    const merged = {
+        provider,
+        model: getEnvValue(env, "AI_MODEL") ?? fileConfig.model ?? defaults.model,
+        apiKey: getEnvValue(env, "AI_API_KEY") ?? fileConfig.apiKey,
+        baseUrl: getEnvValue(env, "AI_BASE_URL") ?? fileConfig.baseUrl ?? defaults.baseUrl,
+        timeoutMs: Number.parseInt(getEnvValue(env, "AI_TIMEOUT_MS") ??
+            String(fileConfig.timeoutMs ?? 30_000), 10) || 30_000,
+        analytics: fileConfig.analytics ?? false,
+        analyticsId: fileConfig.analyticsId
+    };
+    const parsed = finalConfigSchema.safeParse(merged);
+    if (!parsed.success) {
+        if (defaults.requiresApiKey && !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());
+    }
+    if (defaults.requiresApiKey && !parsed.data.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.`);
+    }
+    return {
+        provider: parsed.data.provider,
+        model: parsed.data.model,
+        baseUrl: parsed.data.baseUrl,
+        timeoutMs: parsed.data.timeoutMs,
+        analytics: parsed.data.analytics,
+        ...(parsed.data.analyticsId
+            ? { analyticsId: parsed.data.analyticsId }
+            : {}),
+        ...(parsed.data.apiKey ? { apiKey: parsed.data.apiKey } : {})
+    };
+}
+//# 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,34 @@
+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 ?? [],
+        ...(options.workspaceContext
+            ? { workspaceContext: options.workspaceContext }
+            : {})
+    });
+    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;QAC9B,GAAG,CAAC,OAAO,CAAC,gBAAgB;YAC1B,CAAC,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,EAAE;YAChD,CAAC,CAAC,EAAE,CAAC;KACR,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;gBACE,2EAA2E;aAC5E;YACH,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,8 @@
+import type { ConversationTurn, GenerateObjectRequest, PlatformContext } from "../types/index.js";
+export declare function buildGenerateObjectRequest(options: {
+    question: string;
+    platform: PlatformContext;
+    explainRequested: boolean;
+    history: ConversationTurn[];
+    workspaceContext?: string;
+}): GenerateObjectRequest;

package/dist/core/prompts.js

@@ -0,0 +1,75 @@
+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,
+        "",
+        "Workspace context:",
+        options.workspaceContext ?? "Unavailable.",
+        "",
+        `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 workspace context when it helps choose project-aware commands",
+        "- 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,OAM1C;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,oBAAoB;QACpB,OAAO,CAAC,gBAAgB,IAAI,cAAc;QAC1C,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,qEAAqE;QACrE,oCAAoC;QACpC,yDAAyD;KAC1D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,OAAO;QACL,YAAY;QACZ,UAAU;QACV,UAAU,EAAE,oBAAoB;QAChC,iBAAiB,EACf,gEAAgE;QAClE,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;