moderado 0.3.0

package/dist/index.js

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parseCliArgs, getHelpText } from './args.js';
+import { handleModelsCommand } from './commands/models.js';
+import { handleRunCommand } from './commands/run.js';
+import { handleChatSession } from './commands/chat.js';
+import { handleDoctorCommand } from './commands/doctor.js';
+import { writeDiagnosticLog } from './diagnostic_log.js';
+function getVersion() {
+    try {
+        const __dirname = path.dirname(fileURLToPath(import.meta.url));
+        // Check root VERSION (3 levels up from apps/cli/dist)
+        const rootVersion = path.resolve(__dirname, '../../../VERSION');
+        if (fs.existsSync(rootVersion)) {
+            return fs.readFileSync(rootVersion, 'utf8').trim();
+        }
+        // Check package.json
+        const pkgJson = path.resolve(__dirname, '../package.json');
+        if (fs.existsSync(pkgJson)) {
+            const parsed = JSON.parse(fs.readFileSync(pkgJson, 'utf8'));
+            return `v${parsed.version}`;
+        }
+    }
+    catch {
+        // ignore
+    }
+    return 'v0.1.0';
+}
+async function main() {
+    const args = parseCliArgs();
+    if (args.help) {
+        process.stdout.write(getHelpText());
+        process.exitCode = 0;
+        return;
+    }
+    if (args.version) {
+        process.stdout.write(`${getVersion()}\n`);
+        process.exitCode = 0;
+        return;
+    }
+    const abortController = new AbortController();
+    const handleSigint = () => {
+        process.stdout.write('\n\x1b[33mReceived SIGINT, aborting session gracefully...\x1b[0m\n');
+        abortController.abort();
+    };
+    process.on('SIGINT', handleSigint);
+    process.on('SIGTERM', handleSigint);
+    let exitCode = 0;
+    try {
+        if (args.command === 'doctor') {
+            exitCode = await handleDoctorCommand(args);
+        }
+        else if (args.command === 'models') {
+            exitCode = await handleModelsCommand(args);
+        }
+        else if (args.command === 'run') {
+            exitCode = await handleRunCommand(args, abortController.signal);
+        }
+        else {
+            if (args.nonInteractive) {
+                process.stdout.write(getHelpText());
+                exitCode = 0;
+            }
+            else {
+                exitCode = await handleChatSession(args, getVersion(), abortController.signal);
+            }
+        }
+    }
+    finally {
+        process.off('SIGINT', handleSigint);
+        process.off('SIGTERM', handleSigint);
+    }
+    process.exitCode = exitCode;
+    process.exit(exitCode);
+}
+main().catch((err) => {
+    writeDiagnosticLog(process.argv[2] ?? 'interactive', err);
+    process.stderr.write(`\x1b[1;31mFatal error:\x1b[0m ${err.message}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/model_pricing.d.ts

@@ -0,0 +1,4 @@
+import type { ModelInventoryEntry } from '@moderado/contracts';
+/** Use only exact, provider-advertised prompt and completion prices. */
+export declare function findModelPricing(models: ModelInventoryEntry[], modelId: string): Record<string, string> | undefined;
+//# sourceMappingURL=model_pricing.d.ts.map

package/dist/model_pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model_pricing.d.ts","sourceRoot":"","sources":["../src/model_pricing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,wEAAwE;AACxE,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,mBAAmB,EAAE,EAC7B,OAAO,EAAE,MAAM,GACd,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAOpC"}

package/dist/model_pricing.js

@@ -0,0 +1,10 @@
+/** Use only exact, provider-advertised prompt and completion prices. */
+export function findModelPricing(models, modelId) {
+    const pricing = models.find((model) => model.id === modelId)?.pricing;
+    const prompt = Number(pricing?.prompt);
+    const completion = Number(pricing?.completion);
+    return Number.isFinite(prompt) && prompt >= 0 && Number.isFinite(completion) && completion >= 0
+        ? pricing
+        : undefined;
+}
+//# sourceMappingURL=model_pricing.js.map

package/dist/model_pricing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model_pricing.js","sourceRoot":"","sources":["../src/model_pricing.ts"],"names":[],"mappings":"AAEA,wEAAwE;AACxE,MAAM,UAAU,gBAAgB,CAC9B,MAA6B,EAC7B,OAAe;IAEf,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,OAAO,CAAC,EAAE,OAAO,CAAC;IACtE,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC/C,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,IAAI,CAAC;QAC7F,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC"}

package/dist/sessions.d.ts

@@ -0,0 +1,203 @@
+import { z } from 'zod';
+import { type ChatMessage, type ChatUsage } from '@moderado/contracts';
+export declare const StoredSessionSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    id: z.ZodString;
+    workspaceRoot: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    providerId: z.ZodOptional<z.ZodString>;
+    providerName: z.ZodOptional<z.ZodString>;
+    modelId: z.ZodOptional<z.ZodString>;
+    mode: z.ZodEnum<["Plan", "Execute"]>;
+    messages: z.ZodArray<z.ZodDiscriminatedUnion<"role", [z.ZodObject<{
+        role: z.ZodLiteral<"system">;
+        content: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        role: "system";
+        content: string;
+    }, {
+        role: "system";
+        content: string;
+    }>, z.ZodObject<{
+        role: z.ZodLiteral<"user">;
+        content: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        role: "user";
+        content: string;
+    }, {
+        role: "user";
+        content: string;
+    }>, z.ZodObject<{
+        role: z.ZodLiteral<"assistant">;
+        content: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        toolCalls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            arguments: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            name: string;
+            arguments: Record<string, unknown>;
+        }, {
+            id: string;
+            name: string;
+            arguments: Record<string, unknown>;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        role: "assistant";
+        content: string | null;
+        toolCalls?: {
+            id: string;
+            name: string;
+            arguments: Record<string, unknown>;
+        }[] | undefined;
+    }, {
+        role: "assistant";
+        content?: string | null | undefined;
+        toolCalls?: {
+            id: string;
+            name: string;
+            arguments: Record<string, unknown>;
+        }[] | undefined;
+    }>, z.ZodObject<{
+        role: z.ZodLiteral<"tool">;
+        toolCallId: z.ZodString;
+        name: z.ZodString;
+        content: z.ZodString;
+        status: z.ZodDefault<z.ZodEnum<["success", "error", "denied"]>>;
+    }, "strip", z.ZodTypeAny, {
+        status: "denied" | "success" | "error";
+        name: string;
+        role: "tool";
+        content: string;
+        toolCallId: string;
+    }, {
+        name: string;
+        role: "tool";
+        content: string;
+        toolCallId: string;
+        status?: "denied" | "success" | "error" | undefined;
+    }>]>, "many">;
+    usage: z.ZodObject<{
+        promptTokens: z.ZodNumber;
+        completionTokens: z.ZodNumber;
+        totalTokens: z.ZodNumber;
+        costUsd: z.ZodOptional<z.ZodNumber>;
+        costKnown: z.ZodBoolean;
+        available: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+        costKnown: boolean;
+        available: boolean;
+        costUsd?: number | undefined;
+    }, {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+        costKnown: boolean;
+        costUsd?: number | undefined;
+        available?: boolean | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    mode: "Plan" | "Execute";
+    schemaVersion: 1;
+    workspaceRoot: string;
+    createdAt: string;
+    updatedAt: string;
+    messages: ({
+        role: "system";
+        content: string;
+    } | {
+        role: "user";
+        content: string;
+    } | {
+        role: "assistant";
+        content: string | null;
+        toolCalls?: {
+            id: string;
+            name: string;
+            arguments: Record<string, unknown>;
+        }[] | undefined;
+    } | {
+        status: "denied" | "success" | "error";
+        name: string;
+        role: "tool";
+        content: string;
+        toolCallId: string;
+    })[];
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+        costKnown: boolean;
+        available: boolean;
+        costUsd?: number | undefined;
+    };
+    providerId?: string | undefined;
+    providerName?: string | undefined;
+    modelId?: string | undefined;
+}, {
+    id: string;
+    mode: "Plan" | "Execute";
+    schemaVersion: 1;
+    workspaceRoot: string;
+    createdAt: string;
+    updatedAt: string;
+    messages: ({
+        role: "system";
+        content: string;
+    } | {
+        role: "user";
+        content: string;
+    } | {
+        role: "assistant";
+        content?: string | null | undefined;
+        toolCalls?: {
+            id: string;
+            name: string;
+            arguments: Record<string, unknown>;
+        }[] | undefined;
+    } | {
+        name: string;
+        role: "tool";
+        content: string;
+        toolCallId: string;
+        status?: "denied" | "success" | "error" | undefined;
+    })[];
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+        costKnown: boolean;
+        costUsd?: number | undefined;
+        available?: boolean | undefined;
+    };
+    providerId?: string | undefined;
+    providerName?: string | undefined;
+    modelId?: string | undefined;
+}>;
+export type StoredSession = z.infer<typeof StoredSessionSchema>;
+export declare function createSession(workspaceRoot: string, details?: Partial<Pick<StoredSession, 'providerId' | 'providerName' | 'modelId' | 'mode'>>): StoredSession;
+export declare class SessionStore {
+    private readonly home;
+    constructor(home?: string);
+    getDirectory(workspaceRoot: string): string;
+    getSessionPath(session: StoredSession): string;
+    save(session: StoredSession): void;
+    listSessions(workspaceRoot: string): StoredSession[];
+    loadLatestSession(workspaceRoot: string): StoredSession | undefined;
+}
+export declare function calculateSessionCost(usage: ChatUsage | undefined, pricing?: Record<string, string>): {
+    costKnown: boolean;
+    costUsd?: number;
+};
+/** Output speed uses only generated tokens, never prompt/context processing time. */
+export declare function calculateOutputTokenRate(completionTokens: number, streamDurationMs: number): number | undefined;
+export declare function formatSessionCost(usage: StoredSession['usage']): string;
+export declare function exportSessionMarkdown(session: StoredSession): string;
+export declare function compactSessionMessages(messages: ChatMessage[]): ChatMessage[];
+//# sourceMappingURL=sessions.d.ts.map

package/dist/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../src/sessions.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAqB,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAG1F,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAA8W,CAAC;AAC/Y,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,GAAE,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,YAAY,GAAG,cAAc,GAAG,SAAS,GAAG,MAAM,CAAC,CAAM,GAAG,aAAa,CAGlK;AAED,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,SAAe;IAChD,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IAC3C,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM;IAC9C,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IASlC,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,EAAE;IAOpD,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;CACpE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAI7I;AAED,qFAAqF;AACrF,wBAAgB,wBAAwB,CAAC,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG/G;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,MAAM,CAIvE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAIpE;AACD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAM7E"}

package/dist/sessions.js

@@ -0,0 +1,82 @@
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { z } from 'zod';
+import { ChatMessageSchema } from './vendor/contracts/index.js';
+const UsageSchema = z.object({ promptTokens: z.number().int().nonnegative(), completionTokens: z.number().int().nonnegative(), totalTokens: z.number().int().nonnegative(), costUsd: z.number().nonnegative().optional(), costKnown: z.boolean(), available: z.boolean().default(false) });
+export const StoredSessionSchema = z.object({ schemaVersion: z.literal(1), id: z.string().uuid(), workspaceRoot: z.string().min(1), createdAt: z.string().datetime(), updatedAt: z.string().datetime(), providerId: z.string().optional(), providerName: z.string().optional(), modelId: z.string().optional(), mode: z.enum(['Plan', 'Execute']), messages: z.array(ChatMessageSchema), usage: UsageSchema });
+export function createSession(workspaceRoot, details = {}) {
+    const now = new Date().toISOString();
+    return { schemaVersion: 1, id: crypto.randomUUID(), workspaceRoot, createdAt: now, updatedAt: now, providerId: details.providerId, providerName: details.providerName, modelId: details.modelId, mode: details.mode ?? 'Execute', messages: [], usage: { promptTokens: 0, completionTokens: 0, totalTokens: 0, costKnown: false, available: false } };
+}
+export class SessionStore {
+    home;
+    constructor(home = os.homedir()) {
+        this.home = home;
+    }
+    getDirectory(workspaceRoot) { return path.join(this.home, '.moderado', 'sessions', crypto.createHash('sha256').update(workspaceRoot).digest('hex')); }
+    getSessionPath(session) { return path.join(this.getDirectory(session.workspaceRoot), session.id + '.json'); }
+    save(session) {
+        const checked = StoredSessionSchema.parse({ ...session, updatedAt: new Date().toISOString() });
+        const dir = this.getDirectory(checked.workspaceRoot);
+        fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+        const target = this.getSessionPath(checked);
+        const temp = target + '.' + crypto.randomUUID() + '.tmp';
+        fs.writeFileSync(temp, JSON.stringify(checked, null, 2), { encoding: 'utf8', mode: 0o600 });
+        fs.renameSync(temp, target);
+    }
+    listSessions(workspaceRoot) {
+        const dir = this.getDirectory(workspaceRoot);
+        if (!fs.existsSync(dir))
+            return [];
+        return fs.readdirSync(dir).filter((entry) => entry.endsWith('.json')).flatMap((entry) => {
+            try {
+                return [StoredSessionSchema.parse(JSON.parse(fs.readFileSync(path.join(dir, entry), 'utf8')))];
+            }
+            catch {
+                return [];
+            }
+        }).sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
+    }
+    loadLatestSession(workspaceRoot) { return this.listSessions(workspaceRoot)[0]; }
+}
+export function calculateSessionCost(usage, pricing) {
+    const prompt = Number(pricing?.prompt);
+    const completion = Number(pricing?.completion);
+    if (!usage || !Number.isFinite(prompt) || !Number.isFinite(completion) || prompt < 0 || completion < 0)
+        return { costKnown: false };
+    return { costKnown: true, costUsd: usage.promptTokens * prompt + usage.completionTokens * completion };
+}
+/** Output speed uses only generated tokens, never prompt/context processing time. */
+export function calculateOutputTokenRate(completionTokens, streamDurationMs) {
+    if (!Number.isFinite(completionTokens) || completionTokens <= 0 || !Number.isFinite(streamDurationMs) || streamDurationMs <= 0)
+        return undefined;
+    return completionTokens / (streamDurationMs / 1_000);
+}
+export function formatSessionCost(usage) {
+    if (!usage.available || !usage.costKnown || usage.costUsd === undefined)
+        return 'Cost unknown';
+    if (usage.costUsd === 0)
+        return '$0.00';
+    return `$${usage.costUsd < 0.01 ? usage.costUsd.toFixed(6) : usage.costUsd.toFixed(4)}`;
+}
+function redact(text) { return text.replace(/(?:nvapi-|sk-)[A-Za-z0-9_-]+/g, '[redacted]'); }
+export function exportSessionMarkdown(session) {
+    const lines = ['# Moderado session', '', 'Updated: ' + session.updatedAt, ''];
+    for (const message of session.messages) {
+        if (message.role !== 'tool')
+            lines.push('## ' + message.role, '', redact(message.content ?? ''), '');
+    }
+    return lines.join('\n');
+}
+export function compactSessionMessages(messages) {
+    const conversational = messages.filter((message) => message.role === 'user' || message.role === 'assistant');
+    if (conversational.length <= 4)
+        return [...messages];
+    const removed = conversational.slice(0, -4);
+    const kept = conversational.slice(-4);
+    const summary = removed.map((message) => message.role + ': ' + redact((message.content ?? '').slice(0, 240))).join('\n');
+    return [{ role: 'system', content: 'Compacted ' + removed.length + ' earlier messages:\n' + summary }, ...kept];
+}
+//# sourceMappingURL=sessions.js.map

package/dist/sessions.js.map

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

package/dist/ui/box.d.ts

@@ -0,0 +1,14 @@
+export declare function stripAnsi(text: string): string;
+export declare function getVisibleWidth(text: string): number;
+export interface BoxOptions {
+    title?: string;
+    minWidth?: number;
+    borderColor?: string;
+    titleColor?: string;
+}
+/**
+ * Renders an enclosed Unicode box with mathematically guaranteed alignment
+ * regardless of ANSI color escape codes or string lengths.
+ */
+export declare function renderBox(lines: string[], options?: BoxOptions): string;
+//# sourceMappingURL=box.d.ts.map

package/dist/ui/box.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"box.d.ts","sourceRoot":"","sources":["../../src/ui/box.ts"],"names":[],"mappings":"AACA,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,UAAe,GAAG,MAAM,CA6C3E"}

package/dist/ui/box.js

@@ -0,0 +1,52 @@
+// Strips ANSI escape sequences to compute visual display width
+export function stripAnsi(text) {
+    // eslint-disable-next-line no-control-regex
+    return text.replace(/\x1b\[[0-9;]*[a-zA-Z]/g, '');
+}
+export function getVisibleWidth(text) {
+    return stripAnsi(text).length;
+}
+/**
+ * Renders an enclosed Unicode box with mathematically guaranteed alignment
+ * regardless of ANSI color escape codes or string lengths.
+ */
+export function renderBox(lines, options = {}) {
+    const border = options.borderColor ?? '\x1b[38;5;240m';
+    const reset = '\x1b[0m';
+    const titleColor = options.titleColor ?? '\x1b[1;38;5;75m';
+    // Calculate required width
+    let maxContentWidth = options.title ? getVisibleWidth(options.title) + 4 : 0;
+    for (const line of lines) {
+        if (line !== '---') {
+            const w = getVisibleWidth(line);
+            if (w > maxContentWidth) {
+                maxContentWidth = w;
+            }
+        }
+    }
+    const innerWidth = Math.max(maxContentWidth + 4, options.minWidth ?? 60);
+    let output = '';
+    // 1. Top border
+    if (options.title) {
+        const titleVis = getVisibleWidth(options.title);
+        const rightDashes = innerWidth - titleVis - 3;
+        output += `${border}╭─ ${titleColor}${options.title}${reset}${border} ${'─'.repeat(Math.max(0, rightDashes))}╮${reset}\n`;
+    }
+    else {
+        output += `${border}╭${'─'.repeat(innerWidth)}╮${reset}\n`;
+    }
+    // 2. Content lines
+    for (const line of lines) {
+        if (line === '---') {
+            output += `${border}├${'─'.repeat(innerWidth)}┤${reset}\n`;
+            continue;
+        }
+        const vis = getVisibleWidth(line);
+        const padRight = Math.max(0, innerWidth - vis - 2);
+        output += `${border}│${reset}  ${line}${' '.repeat(padRight)}${border}│${reset}\n`;
+    }
+    // 3. Bottom border
+    output += `${border}╰${'─'.repeat(innerWidth)}╯${reset}\n`;
+    return output;
+}
+//# sourceMappingURL=box.js.map

package/dist/ui/box.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"box.js","sourceRoot":"","sources":["../../src/ui/box.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,4CAA4C;IAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;AAChC,CAAC;AASD;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,KAAe,EAAE,UAAsB,EAAE;IACjE,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,IAAI,gBAAgB,CAAC;IACvD,MAAM,KAAK,GAAG,SAAS,CAAC;IACxB,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,iBAAiB,CAAC;IAE3D,2BAA2B;IAC3B,IAAI,eAAe,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7E,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YACnB,MAAM,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,CAAC,GAAG,eAAe,EAAE,CAAC;gBACxB,eAAe,GAAG,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,GAAG,CAAC,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAEzE,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,gBAAgB;IAChB,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChD,MAAM,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,GAAG,KAAK,GAAG,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC;IAC5H,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,GAAG,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,KAAK,IAAI,CAAC;IAC7D,CAAC;IAED,mBAAmB;IACnB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YACnB,MAAM,IAAI,GAAG,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,KAAK,IAAI,CAAC;YAC3D,SAAS;QACX,CAAC;QAED,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,MAAM,IAAI,KAAK,KAAK,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,IAAI,KAAK,IAAI,CAAC;IACrF,CAAC;IAED,mBAAmB;IACnB,MAAM,IAAI,GAAG,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,KAAK,IAAI,CAAC;IAE3D,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/ui/file_mentions.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Parse `@`-mention tokens out of composer text and expand them to absolute
+ * workspace paths. Only the token directly at the caret is auto-completed;
+ * submission expands every token to a path + excerpt block appended to the
+ * prompt, keeping the model context explicit and approval-free (reads are
+ * auto-approved by the jail).
+ */
+export interface MentionExpansion {
+    /** Prompt sent to the model, with each `@token` replaced by path + excerpt. */
+    text: string;
+    /** Mention tokens that could not be resolved (reported back to the user). */
+    unresolved: string[];
+}
+export declare const IMAGE_EXTENSIONS: Record<string, string>;
+export declare function isImagePath(filePath: string): boolean;
+export declare function getImageMimeType(filePath: string): string | undefined;
+/** Parse the `@`-token that ends at the caret, for autocomplete filtering. */
+export declare function activeMentionToken(input: string, caret: number): {
+    token: string;
+    start: number;
+} | undefined;
+export interface WorkspaceFileSource {
+    listFiles(relativePath: string): Promise<string[]>;
+    readFile(relativePath: string): Promise<string>;
+    readImage?(relativePath: string): Promise<Buffer>;
+}
+export declare function createWorkspaceFileSource(workspaceRoot: string): WorkspaceFileSource;
+export declare function filterMentionCandidates(candidates: string[], token: string, limit?: number): string[];
+/**
+ * Expand every `@token` mention into a fenced block with the file path and a
+ * capped excerpt (first 200 lines) or attached image payload. Unresolvable
+ * tokens are left verbatim and reported, so nothing silently disappears from
+ * the user's prompt.
+ */
+export declare function expandMentions(input: string, workspace: WorkspaceFileSource, options?: {
+    maxExcerptLines?: number;
+}): Promise<MentionExpansion>;
+//# sourceMappingURL=file_mentions.d.ts.map

package/dist/ui/file_mentions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file_mentions.d.ts","sourceRoot":"","sources":["../../src/ui/file_mentions.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAID,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CASnD,CAAC;AAEF,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGrD;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGrE;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAK7G;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACnD,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,SAAS,CAAC,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACnD;AAED,wBAAgB,yBAAyB,CAAC,aAAa,EAAE,MAAM,GAAG,mBAAmB,CAcpF;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,EAAE,CAehG;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,mBAAmB,EAC9B,OAAO,GAAE;IAAE,eAAe,CAAC,EAAE,MAAM,CAAA;CAAO,GACzC,OAAO,CAAC,gBAAgB,CAAC,CAuD3B"}

package/dist/ui/file_mentions.js

@@ -0,0 +1,119 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { listFiles, resolveInJail } from '../vendor/tools/index.js';
+const MENTION_PATTERN = /@([\w./\\-]+)/g;
+export const IMAGE_EXTENSIONS = {
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+    '.svg': 'image/svg+xml',
+    '.bmp': 'image/bmp',
+    '.ico': 'image/x-icon',
+};
+export function isImagePath(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    return ext in IMAGE_EXTENSIONS;
+}
+export function getImageMimeType(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    return IMAGE_EXTENSIONS[ext];
+}
+/** Parse the `@`-token that ends at the caret, for autocomplete filtering. */
+export function activeMentionToken(input, caret) {
+    const before = input.slice(0, caret);
+    const match = /@([\w./\\-]*)$/.exec(before);
+    if (!match)
+        return undefined;
+    return { token: match[1].replace(/\\/g, '/'), start: caret - match[0].length };
+}
+export function createWorkspaceFileSource(workspaceRoot) {
+    return {
+        async listFiles(relativePath) {
+            return listFiles(workspaceRoot, relativePath, { recursive: true, maxDepth: 5, limit: 50 });
+        },
+        async readFile(relativePath) {
+            const canonical = resolveInJail(workspaceRoot, relativePath);
+            return fs.readFileSync(canonical, 'utf8');
+        },
+        async readImage(relativePath) {
+            const canonical = resolveInJail(workspaceRoot, relativePath);
+            return fs.readFileSync(canonical);
+        },
+    };
+}
+export function filterMentionCandidates(candidates, token, limit = 8) {
+    const q = token.toLowerCase().trim();
+    if (!q)
+        return candidates.slice(0, limit);
+    const exactStart = [];
+    const substring = [];
+    for (const candidate of candidates) {
+        const normalized = candidate.toLowerCase();
+        const base = path.basename(candidate).toLowerCase();
+        if (base.startsWith(q) || normalized.startsWith(q)) {
+            exactStart.push(candidate);
+        }
+        else if (normalized.includes(q)) {
+            substring.push(candidate);
+        }
+    }
+    return [...exactStart, ...substring].slice(0, limit);
+}
+/**
+ * Expand every `@token` mention into a fenced block with the file path and a
+ * capped excerpt (first 200 lines) or attached image payload. Unresolvable
+ * tokens are left verbatim and reported, so nothing silently disappears from
+ * the user's prompt.
+ */
+export async function expandMentions(input, workspace, options = {}) {
+    const maxLines = options.maxExcerptLines ?? 200;
+    const unresolved = [];
+    let text = input;
+    const matches = [...input.matchAll(MENTION_PATTERN)];
+    for (const match of matches.reverse()) {
+        const rawToken = match[1];
+        const token = rawToken.replace(/\\/g, '/');
+        const full = `@${rawToken}`;
+        try {
+            const files = await workspace.listFiles(token);
+            const target = files.length === 1 ? files[0] : files[0] ?? token;
+            if (isImagePath(target)) {
+                const mime = getImageMimeType(target) ?? 'application/octet-stream';
+                if (workspace.readImage) {
+                    const buffer = await workspace.readImage(target);
+                    if (buffer.byteLength > 1024 * 1024) {
+                        text = text.replace(full, `\n--- @${target} (image) ---\n[Attached image: ${target} (${mime}, ${buffer.byteLength} bytes - exceeded 1MB inline limit)]\n--- end @${target} ---`);
+                    }
+                    else {
+                        const base64 = buffer.toString('base64');
+                        text = text.replace(full, `\n--- @${target} (image) ---\n[Attached image: ${target} (${mime}, ${buffer.byteLength} bytes)]\ndata:${mime};base64,${base64}\n--- end @${target} ---`);
+                    }
+                }
+                else {
+                    try {
+                        const content = await workspace.readFile(target);
+                        text = text.replace(full, `\n--- @${target} ---\n${content}\n--- end @${target} ---`);
+                    }
+                    catch {
+                        text = text.replace(full, `\n--- @${target} (image) ---\n[Attached image: ${target} (${mime})]\n--- end @${target} ---`);
+                    }
+                }
+            }
+            else {
+                const content = await workspace.readFile(target);
+                const lines = content.split(/\r?\n/).slice(0, maxLines);
+                text = text.replace(full, `\n--- @${target} ---\n${lines.join('\n')}\n--- end @${target} ---`);
+            }
+        }
+        catch {
+            unresolved.push(full);
+        }
+    }
+    for (const missing of unresolved) {
+        text = text.replace(missing, `${missing} (file not found)`);
+    }
+    return { text: text.trim(), unresolved };
+}
+//# sourceMappingURL=file_mentions.js.map