@denizokcu/haze 0.0.2 → 0.0.3

package/dist/skills/builder/SkillBuilder.js

@@ -27,42 +27,67 @@ description: Use when the user asks Haze to create a new skill from a natural-la
 You create predictable, high-quality Haze skills.
 
 A Haze skill is a directory in ~/.haze/skills containing SKILL.md and optional referenced files.
-SKILL.md must be Markdown with YAML frontmatter:
+SKILL.md must be Markdown with YAML frontmatter, followed by a role and focused prompt:
 
 ---
 name: kebab-case-name
 description: Use when the user asks ...
 ---
 
+# Role
+You are a focused, practical assistant for this workflow.
+
+# Focused prompt
+Complete the user's goal with the smallest reliable workflow.
+
 The description must tell the model exactly when to use the skill.
 The body must be a deterministic operating procedure, not generic advice.
+Keep skills simple, short, and practical: prefer the fewest commands and sections that reliably complete the workflow.
+Avoid exhaustive checklists, rigid citation requirements, or heavyweight output formats unless the user's request truly requires them.
 Additional files are allowed only when SKILL.md explicitly references them with relative paths.
 Skills do not execute code. They teach Haze how to behave for a workflow.
 
-Every skill you create must include:
-- Goal: the user's underlying intent, outcome, and definition of success inferred from their description.
-- Trigger: when to use the skill.
-- Inputs to inspect: exact commands/files/state to read, with incremental inspection for large outputs.
-- Procedure: ordered steps with fallback paths for empty, missing, or truncated primary inputs.
+Every skill you create must include, in this order:
+- YAML frontmatter.
+- Role: the specific assistant role to adopt for this workflow.
+- Focused prompt: a concise directive that explains the goal and keeps the workflow scoped.
+- Inputs to inspect: only the essential commands/files/state needed for the workflow, with incremental inspection for large outputs.
+- Procedure: a short ordered list with fallback paths for empty, missing, or truncated primary inputs.
 - Stop conditions: when it is valid to say there is nothing to do.
 - Blocker policy: concrete conditions that justify stopping, excluding truncation when narrower inspection is possible.
-- Output format: predictable sections for the final answer.
-- Evidence rule: require final answers to be grounded in actual inspected content.
+- Output template: a compact, reusable final-answer template with predictable headings/placeholders.
+- Evidence rule: require final answers to be grounded in actual inspected content, but do not require exhaustive citations.
 
-Infer the user's intent from their wording and make that intent the explicit goal of the skill. A good goal states what the skill should accomplish, not just what commands it should run.
-Avoid fragile skills that stop after one empty command or one truncated command. If a workflow has common edge cases, encode them explicitly.
-For diff/review skills, require this pattern: get branch/status/stat/name-only first; if a full diff is empty, inspect staged and unstaged diffs; if a full diff is truncated, inspect targeted per-file diffs or read changed files before reviewing.
+Infer the user's intent from their wording and make that intent explicit in the Focused prompt. A good focused prompt states what the skill should accomplish, not just what commands it should run.
+Favor skills that a small or slower model can follow in one pass. The model should be able to finish with a concise response after a small number of tool calls.
+Avoid fragile skills that stop after one empty command or one truncated command, but do not over-correct by requiring exhaustive inspection. Encode only common, necessary fallbacks.
+For diff/review skills, keep the default path simple: get status/stat/name-only, inspect unstaged and staged diffs if present, and if no changes or target exist, return a short no-changes response. Use targeted per-file diffs only when the full diff is too large or truncated.
 Do not require exact line citations for every finding in generated skills; require concrete file/function/code-area evidence instead, with exact lines only when available.
 `;
 const generatedSkillSchema = z.object({
-    name: z.string().min(1).describe('Kebab-case skill name'),
+    name: z.string().min(1).describe('Meaningful kebab-case skill name with 2-4 words'),
     files: z.array(z.object({
         path: z.string().min(1).describe('Relative file path inside the skill directory'),
         content: z.string().describe('Complete file content'),
     })).min(1).describe('Generated skill files, including SKILL.md'),
 });
+const SKILL_NAME_STOP_WORDS = new Set([
+    'a', 'an', 'the', 'to', 'for', 'with', 'and', 'or', 'of', 'in', 'on', 'my', 'our', 'me', 'i', 'from', 'against', 'as', 'by', 'into', 'using', 'use', 'when', 'asks', 'ask',
+]);
+const SKILL_NAME_TRAILING_FILLER_WORDS = new Set([
+    'write', 'create', 'make', 'build', 'generate', 'do', 'run', 'handle', 'help', 'using', 'with', 'for', 'to',
+]);
 export function slug(s) {
-    return s.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '').slice(0, 40) || 'custom-skill';
+    const rawWords = s.toLowerCase().match(/[a-z0-9]+/g) ?? [];
+    const meaningfulWords = rawWords.filter(word => !SKILL_NAME_STOP_WORDS.has(word));
+    const words = (meaningfulWords.length >= 2 ? meaningfulWords : rawWords).slice(0, 4);
+    while (words.length > 2 && SKILL_NAME_TRAILING_FILLER_WORDS.has(words.at(-1) ?? ''))
+        words.pop();
+    if (words.length === 0)
+        return 'custom-skill';
+    if (words.length === 1)
+        words.push(words[0] === 'custom' ? 'skill' : 'workflow');
+    return words.join('-');
 }
 function yamlString(value) {
     return JSON.stringify(value);
@@ -73,13 +98,30 @@ function fallbackSkill(description) {
         name,
         files: [{
                 path: 'SKILL.md',
-                content: `---\nname: ${name}\ndescription: ${yamlString(`Use when the user asks: ${description}`)}\n---\n\n# Goal\n\nAccomplish the user's intended outcome: ${description}\n\n# Trigger\n\nUse this skill when the user asks: ${description}\n\n# Inputs to inspect\n\nIdentify the concrete commands, files, diffs, logs, or project state needed for this workflow. Inspect actual content, not only summaries.\n\n# Procedure\n\n1. Confirm the relevant project state.\n2. Inspect the primary input for the workflow.\n3. If the primary input is empty, unavailable, or truncated, inspect natural fallback inputs or narrower targeted inputs before stopping.\n4. For large inputs, inspect summaries first, then targeted files, sections, or commands most relevant to the goal.\n5. Perform the requested analysis or implementation using the inspected evidence.\n6. Produce the final answer in the output format below.\n\n# Stop conditions\n\nOnly say there is nothing to do after every relevant input source has been checked and is empty.\n\n# Blocker policy\n\nOnly stop as blocked for a concrete tool failure, missing permission, unavailable dependency, or ambiguous requirement that prevents progress. Truncated output is not a blocker when narrower follow-up inspection is possible.\n\n# Output format\n\n- Summary\n- Findings or actions\n- Evidence inspected\n- Recommendation or next step\n${STANDARD_SKILL_REQUIREMENTS}\n# References\n\nAdd relative file references here if this skill needs examples, templates, or supporting docs.\n`,
+                content: `---\nname: ${name}\ndescription: ${yamlString(`Use when the user asks: ${description}`)}\n---\n\n# Role\n\nYou are a focused, practical assistant for this workflow.\n\n# Focused prompt\n\nAccomplish the user's intended outcome with the smallest reliable workflow: ${description}\n\n# Inputs to inspect\n\nIdentify the concrete commands, files, diffs, logs, or project state needed for this workflow. Inspect actual content, not only summaries.\n\n# Procedure\n\n1. Confirm the relevant project state.\n2. Inspect the primary input for the workflow.\n3. If the primary input is empty, unavailable, or truncated, inspect natural fallback inputs or narrower targeted inputs before stopping.\n4. For large inputs, inspect summaries first, then targeted files, sections, or commands most relevant to the goal.\n5. Perform the requested analysis or implementation using the inspected evidence.\n6. Produce the final answer using the output template below.\n\n# Stop conditions\n\nOnly say there is nothing to do after every relevant input source has been checked and is empty.\n\n# Blocker policy\n\nOnly stop as blocked for a concrete tool failure, missing permission, unavailable dependency, or ambiguous requirement that prevents progress. Truncated output is not a blocker when narrower follow-up inspection is possible.\n\n# Output template\n\n## Summary\n- <one-to-three bullets with the result>\n\n## Actions or findings\n- <concrete actions taken or findings discovered>\n\n## Evidence inspected\n- <commands, files, diffs, or outputs used>\n\n## Next step\n- <recommended next action, or "None" if complete>\n${STANDARD_SKILL_REQUIREMENTS}\n# References\n\nAdd relative file references here if this skill needs examples, templates, or supporting docs.\n`,
             }],
     };
 }
 function withStandardRequirements(content) {
     return content.includes('# Operational guardrails') ? content : `${content.trim()}${STANDARD_SKILL_REQUIREMENTS}\n`;
 }
+function withSkillName(content, name) {
+    if (/^---\n[\s\S]*?^name:\s*.*$/m.test(content))
+        return content.replace(/^(---\n[\s\S]*?^name:\s*).*$/m, `$1${name}`);
+    return content;
+}
+function normalizeSkillDescription(description) {
+    const trimmed = description.replace(/\s+/g, ' ').trim();
+    if (!trimmed)
+        return 'Use when the user asks for this workflow.';
+    return /^use when\b/i.test(trimmed) ? trimmed : `Use when ${trimmed.charAt(0).toLowerCase()}${trimmed.slice(1)}`;
+}
+function withSkillDescription(content, description) {
+    const normalized = normalizeSkillDescription(description);
+    if (/^---\n[\s\S]*?^description:\s*.*$/m.test(content))
+        return content.replace(/^(---\n[\s\S]*?^description:\s*).*$/m, `$1${yamlString(normalized)}`);
+    return content;
+}
 function extractJson(text) {
     const fenced = /```(?:json)?\s*([\s\S]*?)\s*```/.exec(text);
     return fenced?.[1] ?? text;
@@ -94,6 +136,71 @@ function parseGeneratedSkill(text, description) {
         throw new Error('Generated skill did not include SKILL.md');
     return { name, files };
 }
+async function descriptionFromSkillSummary(description, finalName, files) {
+    const skillMd = files.find(file => file.path === 'SKILL.md')?.content;
+    if (!skillMd)
+        return normalizeSkillDescription(`the user asks: ${description}`);
+    const activeModel = await model();
+    if (!activeModel)
+        return normalizeSkillDescription(`the user asks: ${description}`);
+    const result = await generateObject({
+        model: activeModel,
+        temperature: 0,
+        schema: z.object({ description: z.string().min(1).describe('Final Use when description that tells an LLM when to invoke this skill') }),
+        schemaName: 'GeneratedHazeSkillDescription',
+        schemaDescription: 'A final skill description chosen from the complete generated SKILL.md.',
+        prompt: [
+            'Write the final Haze skill frontmatter description after reading the entire generated SKILL.md.',
+            '',
+            `Original user request: ${description}`,
+            `Final skill name: ${finalName}`,
+            '',
+            'Description rules:',
+            '- Start with "Use when".',
+            '- Optimize for LLM understandability: make it obvious when this skill should be invoked.',
+            '- Summarize the actual workflow in the SKILL.md, not only the user wording.',
+            '- Be specific about the trigger and desired outcome.',
+            '- Keep it one sentence, concise but complete.',
+            '- Avoid vague descriptions like "Use when the user asks for this workflow" unless no better signal exists.',
+            '',
+            'Generated SKILL.md:',
+            skillMd,
+        ].join('\n'),
+    });
+    return normalizeSkillDescription(result.object.description || `the user asks: ${description}`);
+}
+async function nameFromSkillSummary(description, generatedName, files) {
+    const skillMd = files.find(file => file.path === 'SKILL.md')?.content;
+    if (!skillMd)
+        return slug(generatedName || description);
+    const activeModel = await model();
+    if (!activeModel)
+        return slug(generatedName || description);
+    const result = await generateObject({
+        model: activeModel,
+        temperature: 0,
+        schema: z.object({ name: z.string().min(1).describe('Final meaningful 2-4 word kebab-case skill name') }),
+        schemaName: 'GeneratedHazeSkillName',
+        schemaDescription: 'A final skill name chosen from the complete generated SKILL.md.',
+        prompt: [
+            'Choose the final Haze skill directory name after reading the entire generated SKILL.md.',
+            '',
+            `Original user request: ${description}`,
+            `Draft/generated name: ${generatedName}`,
+            '',
+            'Naming rules:',
+            '- Return 2-4 meaningful words in kebab-case.',
+            '- The name must summarize the whole skill workflow, not just copy the first words of the request.',
+            '- Do not include a loose trailing word from a cut-off sentence. Bad: commit-current-changes-write. Good: commit-current-changes.',
+            '- Prefer nouns that convey the outcome, such as review, commit, release-notes, migration, validation, or triage.',
+            '- Avoid vague words like helper, workflow, custom-skill, write, create, make, or do unless they are essential to the meaning.',
+            '',
+            'Generated SKILL.md:',
+            skillMd,
+        ].join('\n'),
+    });
+    return slug(result.object.name || generatedName || description);
+}
 function assertSafeGeneratedFile(filePath) {
     if (path.isAbsolute(filePath))
         throw new Error(`Generated skill file must be relative: ${filePath}`);
@@ -107,7 +214,7 @@ function assertSafeGeneratedFile(filePath) {
 async function generateSkill(description) {
     const activeModel = await model();
     if (!activeModel)
-        throw new Error('No API key configured. Run /login, then /model x-ai/grok-build-0.1, before using /skill create.');
+        throw new Error('No model provider configured. Run /provider to choose or add a provider before using /create-skill.');
     const result = await generateObject({
         model: activeModel,
         temperature: 0,
@@ -121,12 +228,20 @@ async function generateSkill(description) {
             '',
             'Rules:',
             '- SKILL.md must include frontmatter with name and description.',
+            '- The skill name must be 2-4 meaningful words in kebab-case and convey the workflow intent, for example "branch-diff-review" or "release-notes-draft".',
+            '- Pick the name as if it were written after summarizing the complete SKILL.md, not by truncating the first words of the request.',
+            '- Do not include loose trailing words from cut-off sentences. Bad: "commit-current-changes-write". Good: "commit-current-changes".',
+            '- Avoid vague names like "helper", "workflow", or "custom-skill" unless paired with a specific domain word.',
             '- The frontmatter description must start with "Use when".',
-            '- Infer the user intent from the description and make it the explicit Goal of the skill.',
-            '- The body must use these headings: Goal, Trigger, Inputs to inspect, Procedure, Fallbacks, Stop conditions, Blocker policy, Output format.',
-            '- The Goal must describe the desired outcome and definition of success, not just restate the trigger.',
-            '- Procedure steps must name exact commands/files/state to inspect whenever the workflow implies them.',
-            '- Include fallback behavior for empty or truncated primary inputs. Example: if branch diff is empty, inspect staged and unstaged changes before stopping; if full diff is truncated, inspect per-file diffs or read changed files.',
+            '- Infer the user intent from the description and make it explicit in the Focused prompt.',
+            '- The body must start with these headings immediately after frontmatter: Role, Focused prompt.',
+            '- The body must then include these headings: Inputs to inspect, Procedure, Fallbacks, Stop conditions, Blocker policy, Output template.',
+            '- The Focused prompt must describe the desired outcome and definition of success, not just restate the trigger.',
+            '- Keep the skill simple enough for a small or slower model to complete in one pass.',
+            '- Prefer short procedures, compact final output templates, and the minimum necessary tool calls.',
+            '- Avoid exhaustive checklists, mandatory line citations for every claim, and large rigid report templates unless the user explicitly asks for them.',
+            '- Procedure steps must name exact commands/files/state to inspect whenever the workflow implies them, but only include essential inspections.',
+            '- Include fallback behavior for empty or truncated primary inputs. Example: if branch diff is empty, inspect staged and unstaged changes before stopping; if no changes or target exist, return a concise no-changes response; if full diff is truncated, inspect per-file diffs or read changed files.',
             '- For workflows with potentially large outputs, require incremental inspection: stat/name-only/summary first, then targeted content reads.',
             '- Define when it is valid to say "nothing to do".',
             '- Define blockers narrowly: concrete tool failure, missing permission/dependency, or ambiguous requirement. Truncation alone is not a blocker if targeted follow-up inspection is possible.',
@@ -136,11 +251,18 @@ async function generateSkill(description) {
         ].join('\n'),
     });
     const generated = result.object;
-    return { name: slug(generated.name || description), files: generated.files };
+    const draftName = slug(generated.name || description);
+    const finalName = await nameFromSkillSummary(description, draftName, generated.files).catch(() => draftName);
+    const finalDescription = await descriptionFromSkillSummary(description, finalName, generated.files).catch(() => normalizeSkillDescription(`the user asks: ${description}`));
+    const files = generated.files.map(file => file.path === 'SKILL.md' ? { ...file, content: withSkillDescription(file.content, finalDescription) } : file);
+    return { name: finalName, files };
 }
 export async function createSkill(description) {
     const generated = await generateSkill(description).catch(error => {
-        throw error instanceof Error ? error : new Error(String(error));
+        const message = error instanceof Error ? error.message : String(error);
+        if (message.startsWith('No model provider configured.'))
+            throw error instanceof Error ? error : new Error(message);
+        return fallbackSkill(description);
     });
     const name = generated.name || fallbackSkill(description).name;
     const dir = path.join(GLOBAL_SKILLS_DIR, name);
@@ -152,7 +274,7 @@ export async function createSkill(description) {
         const safePath = assertSafeGeneratedFile(generatedFile.path);
         const absolutePath = path.join(dir, safePath);
         await fs.ensureDir(path.dirname(absolutePath));
-        const content = safePath === 'SKILL.md' ? withStandardRequirements(generatedFile.content) : generatedFile.content;
+        const content = safePath === 'SKILL.md' ? withSkillName(withStandardRequirements(generatedFile.content), name) : generatedFile.content;
         await fs.writeFile(absolutePath, content, 'utf8');
     }
     if (!(await fs.pathExists(skillFile))) {
@@ -171,4 +293,4 @@ export async function createSkill(description) {
     }
     return { name, dir, file: skillFile };
 }
-export const internals = { SKILL_CREATOR_SKILL, STANDARD_SKILL_REQUIREMENTS, parseGeneratedSkill, fallbackSkill, withStandardRequirements };
+export const internals = { SKILL_CREATOR_SKILL, STANDARD_SKILL_REQUIREMENTS, parseGeneratedSkill, fallbackSkill, withStandardRequirements, withSkillName, withSkillDescription, normalizeSkillDescription };

package/dist/ui/components/ErrorView.d.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 export declare function ErrorView({ error }: {
     error: unknown;
-}): import("react/jsx-runtime").JSX.Element;
+}): React.JSX.Element;

package/dist/ui/components/Header.d.ts

@@ -1,4 +1,5 @@
+import React from 'react';
 export declare function Header({ subtitle, version }: {
     subtitle?: string;
     version?: string;
-}): import("react/jsx-runtime").JSX.Element;
+}): React.JSX.Element;

package/dist/ui/components/Header.js

@@ -1,16 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text } from 'ink';
 import { theme } from '../theme.js';
-const logo = [
-    '  _                   ',
-    ' | |                  ',
-    ' | |__   __ _ _______ ',
-    " | '_ \\ / _` |_  / _ \\",
-    ' | | | | (_| |/ /  __/',
-    ' |_| |_|\\__,_/___\\___|',
-];
 export function Header({ subtitle, version }) {
-    return _jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [logo.map((line, index) => index === logo.length - 1
-                ? _jsxs(Box, { children: [_jsx(Text, { color: index % 2 === 0 ? theme.purple : theme.violet, bold: true, children: line }), version ? _jsxs(Text, { color: theme.muted, children: [" v", version] }) : null] }, line)
-                : _jsx(Text, { color: index % 2 === 0 ? theme.purple : theme.violet, bold: true, children: line }, line)), _jsx(Text, { children: " " }), _jsx(Text, { color: theme.muted, children: subtitle ?? 'A tiny terminal fog machine for building software.' })] });
+    return _jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(Text, { color: theme.purple, bold: true, children: "haze" }), version ? _jsxs(Text, { color: theme.muted, children: [" v", version] }) : null] }), _jsx(Text, { children: " " }), _jsx(Text, { color: theme.muted, children: subtitle ?? 'A tiny terminal fog machine for building software.' })] });
 }

package/dist/ui/components/MarkdownText.d.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 export declare function MarkdownText({ content }: {
     content: string;
-}): import("react/jsx-runtime").JSX.Element;
+}): React.JSX.Element;

package/dist/ui/components/TextInput.d.ts

@@ -1,16 +1,20 @@
+import React from 'react';
 export type TextInputSuggestion = {
     value: string;
     description?: string;
-    kind?: 'command' | 'skill';
+    kind?: 'command' | 'skill' | 'provider' | 'model';
 };
-export declare function TextInput({ placeholder, disabled, mask, historyItems, recordHistory, suggestions, onHistoryAdd, onCancel, onSubmit }: {
+export declare function TextInput({ placeholder, disabled, mask, historyItems, recordHistory, suggestions, suggestionMode, submitOnEmpty, onHistoryAdd, onCancel, onEscape, onSubmit }: {
     placeholder?: string;
     disabled?: boolean;
     mask?: boolean;
     historyItems?: string[];
     recordHistory?: boolean;
     suggestions?: TextInputSuggestion[];
+    suggestionMode?: 'slash' | 'always';
+    submitOnEmpty?: boolean;
     onHistoryAdd?: (value: string) => void;
     onCancel?: () => void;
+    onEscape?: () => void;
     onSubmit: (value: string) => void;
-}): import("react/jsx-runtime").JSX.Element;
+}): React.JSX.Element;

package/dist/ui/components/TextInput.js

@@ -2,12 +2,63 @@ import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-run
 import { useEffect, useRef, useState } from 'react';
 import { Box, Text, useInput } from 'ink';
 import { theme } from '../theme.js';
-export function TextInput({ placeholder, disabled, mask, historyItems = [], recordHistory = true, suggestions = [], onHistoryAdd, onCancel, onSubmit }) {
+const COMPACT_PASTE_MIN_LINES = 4;
+function normalizeLineEndings(text) {
+    return text.replace(/\r\n|\r/g, '\n');
+}
+function lineCount(text) {
+    return normalizeLineEndings(text).split('\n').length;
+}
+function pastePlaceholder(block) {
+    return `[paste #${block.id} +${block.lineCount} lines]`;
+}
+function updatePasteBlocksForReplacement(blocks, start, end, insertedLength) {
+    const delta = insertedLength - (end - start);
+    return blocks.flatMap(block => {
+        const replacesInsideBlock = start < block.end && end > block.start;
+        const insertsInsideBlock = start === end && start > block.start && start < block.end;
+        if (replacesInsideBlock || insertsInsideBlock)
+            return [];
+        if (block.start >= end)
+            return [{ ...block, start: block.start + delta, end: block.end + delta }];
+        return [block];
+    });
+}
+function displayCursorForValueCursor(blocks, valueCursor) {
+    let displayCursor = valueCursor;
+    for (const block of [...blocks].sort((a, b) => a.start - b.start)) {
+        const placeholderLength = pastePlaceholder(block).length;
+        const compactedLength = block.end - block.start - placeholderLength;
+        if (valueCursor <= block.start)
+            break;
+        if (valueCursor < block.end)
+            return block.start + placeholderLength;
+        displayCursor -= compactedLength;
+    }
+    return displayCursor;
+}
+function compactPasteBlocksForDisplay(value, blocks) {
+    if (blocks.length === 0)
+        return value;
+    let displayValue = '';
+    let offset = 0;
+    for (const block of [...blocks].sort((a, b) => a.start - b.start)) {
+        displayValue += value.slice(offset, block.start);
+        displayValue += pastePlaceholder(block);
+        offset = block.end;
+    }
+    displayValue += value.slice(offset);
+    return displayValue;
+}
+export function TextInput({ placeholder, disabled, mask, historyItems = [], recordHistory = true, suggestions = [], suggestionMode = 'slash', submitOnEmpty = false, onHistoryAdd, onCancel, onEscape, onSubmit }) {
     const [value, setValue] = useState('');
     const [cursor, setCursor] = useState(0);
+    const [pasteBlocks, setPasteBlocks] = useState([]);
+    const [selectedSuggestionIndex, setSelectedSuggestionIndex] = useState(0);
     const history = useRef(historyItems);
     const historyIndex = useRef(null);
     const draft = useRef('');
+    const nextPasteId = useRef(1);
     useEffect(() => {
         history.current = historyItems;
     }, [historyItems]);
@@ -15,28 +66,50 @@ export function TextInput({ placeholder, disabled, mask, historyItems = [], reco
         if (!disabled) {
             setValue('');
             setCursor(0);
+            setPasteBlocks([]);
+            setSelectedSuggestionIndex(0);
             historyIndex.current = null;
             draft.current = '';
+            nextPasteId.current = 1;
         }
     }, [disabled]);
-    function setInput(next, nextCursor = next.length) {
+    function setInput(next, nextCursor = next.length, nextPasteBlocks = []) {
         setValue(next);
         setCursor(Math.max(0, Math.min(nextCursor, next.length)));
+        setPasteBlocks(nextPasteBlocks);
+        setSelectedSuggestionIndex(0);
+    }
+    function replaceInput(start, end, inserted) {
+        const normalizedInserted = normalizeLineEndings(inserted);
+        const next = value.slice(0, start) + normalizedInserted + value.slice(end);
+        const insertedLineCount = lineCount(normalizedInserted);
+        const updatedPasteBlocks = updatePasteBlocksForReplacement(pasteBlocks, start, end, normalizedInserted.length);
+        const insertedPasteBlock = !mask && insertedLineCount >= COMPACT_PASTE_MIN_LINES
+            ? [{ id: nextPasteId.current++, start, end: start + normalizedInserted.length, lineCount: insertedLineCount }]
+            : [];
+        setInput(next, start + normalizedInserted.length, [...updatedPasteBlocks, ...insertedPasteBlock]);
+        historyIndex.current = null;
     }
     function showHistory(index) {
         historyIndex.current = index;
         setInput(history.current[index] ?? '');
     }
-    const slashQuery = !mask && value.startsWith('/') ? value.slice(1).toLowerCase() : undefined;
-    const filteredSuggestions = slashQuery == null ? [] : suggestions
-        .filter(suggestion => suggestion.value.slice(1).toLowerCase().includes(slashQuery) || suggestion.description?.toLowerCase().includes(slashQuery))
+    const suggestionQuery = !mask && (suggestionMode === 'always' || value.startsWith('/'))
+        ? (suggestionMode === 'always' ? value : value.slice(1)).toLowerCase()
+        : undefined;
+    const filteredSuggestions = suggestionQuery == null ? [] : suggestions
+        .filter(suggestion => {
+        const suggestionValue = suggestionMode === 'always' ? suggestion.value : suggestion.value.slice(1);
+        return suggestionValue.toLowerCase().includes(suggestionQuery) || suggestion.description?.toLowerCase().includes(suggestionQuery);
+    })
         .slice(0, 8);
-    const topSuggestion = filteredSuggestions[0];
-    function submitValue(submitted) {
-        if (recordHistory) {
-            if (history.current[history.current.length - 1] !== submitted)
-                history.current = [...history.current, submitted];
-            onHistoryAdd?.(submitted);
+    const activeSuggestionIndex = Math.min(selectedSuggestionIndex, Math.max(0, filteredSuggestions.length - 1));
+    const activeSuggestion = filteredSuggestions[activeSuggestionIndex];
+    function submitValue(submitted, historyValue = submitted) {
+        if (recordHistory && historyValue) {
+            if (history.current[history.current.length - 1] !== historyValue)
+                history.current = [...history.current, historyValue];
+            onHistoryAdd?.(historyValue);
         }
         onSubmit(submitted);
     }
@@ -50,20 +123,26 @@ export function TextInput({ placeholder, disabled, mask, historyItems = [], reco
             setInput('');
             historyIndex.current = null;
             draft.current = '';
+            nextPasteId.current = 1;
+            onEscape?.();
             return;
         }
-        if (key.tab && topSuggestion) {
-            setInput(topSuggestion.value);
+        if (key.tab && activeSuggestion) {
+            setInput(activeSuggestion.value);
             historyIndex.current = null;
             return;
         }
         if (key.return) {
-            const submitted = (value.startsWith('/') && topSuggestion && topSuggestion.value !== value.trim()) ? topSuggestion.value : value.trim();
+            const shouldUseSuggestion = activeSuggestion && activeSuggestion.value !== value.trim() && (suggestionMode === 'always' || value.startsWith('/'));
+            const submitted = shouldUseSuggestion ? activeSuggestion.value : value.trim();
+            const submittedSuggestion = activeSuggestion?.value === submitted ? activeSuggestion : undefined;
+            const historyValue = submittedSuggestion && submittedSuggestion.kind !== 'command' ? '' : submitted;
             setInput('');
             historyIndex.current = null;
             draft.current = '';
-            if (submitted)
-                submitValue(submitted);
+            nextPasteId.current = 1;
+            if (submitted || submitOnEmpty)
+                submitValue(submitted, historyValue);
             return;
         }
         if (key.leftArrow) {
@@ -75,6 +154,10 @@ export function TextInput({ placeholder, disabled, mask, historyItems = [], reco
             return;
         }
         if (key.upArrow) {
+            if (filteredSuggestions.length > 0 && activeSuggestionIndex > 0) {
+                setSelectedSuggestionIndex(current => Math.max(0, current - 1));
+                return;
+            }
             if (history.current.length === 0)
                 return;
             if (historyIndex.current === null) {
@@ -87,6 +170,10 @@ export function TextInput({ placeholder, disabled, mask, historyItems = [], reco
             return;
         }
         if (key.downArrow) {
+            if (filteredSuggestions.length > 0 && activeSuggestionIndex < filteredSuggestions.length - 1) {
+                setSelectedSuggestionIndex(current => Math.min(filteredSuggestions.length - 1, current + 1));
+                return;
+            }
             if (historyIndex.current === null)
                 return;
             if (historyIndex.current < history.current.length - 1) {
@@ -101,15 +188,13 @@ export function TextInput({ placeholder, disabled, mask, historyItems = [], reco
         if (key.backspace) {
             if (cursor === 0)
                 return;
-            setInput(value.slice(0, cursor - 1) + value.slice(cursor), cursor - 1);
-            historyIndex.current = null;
+            replaceInput(cursor - 1, cursor, '');
             return;
         }
         if (key.delete) {
             if (cursor >= value.length)
                 return;
-            setInput(value.slice(0, cursor) + value.slice(cursor + 1), cursor);
-            historyIndex.current = null;
+            replaceInput(cursor, cursor + 1, '');
             return;
         }
         if (key.ctrl && input === 'a') {
@@ -123,13 +208,13 @@ export function TextInput({ placeholder, disabled, mask, historyItems = [], reco
         if (key.ctrl && input === 'c')
             return;
         if (input) {
-            setInput(value.slice(0, cursor) + input + value.slice(cursor), cursor + input.length);
-            historyIndex.current = null;
+            replaceInput(cursor, cursor, input);
         }
     });
-    const displayValue = mask ? '•'.repeat(value.length) : value;
-    const beforeCursor = displayValue.slice(0, cursor);
-    const cursorChar = displayValue[cursor] ?? ' ';
-    const afterCursor = displayValue.slice(cursor + 1);
-    return _jsxs(Box, { flexDirection: "column", width: "100%", children: [filteredSuggestions.length > 0 && _jsx(Box, { flexDirection: "column", marginBottom: 1, children: filteredSuggestions.map((suggestion, index) => _jsxs(Text, { color: index === 0 ? theme.success : theme.muted, wrap: "truncate-end", children: [index === 0 ? '› ' : '  ', suggestion.value, _jsxs(Text, { color: theme.muted, children: [" ", suggestion.kind === 'skill' ? 'skill' : 'command', suggestion.description ? ` — ${suggestion.description}` : ''] })] }, suggestion.value)) }), _jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { color: theme.purple, children: "\u203A " }), value.length === 0 ? _jsxs(_Fragment, { children: [_jsx(Text, { inverse: true, children: " " }), _jsxs(Text, { color: theme.muted, dimColor: true, children: [" ", placeholder ?? 'Type a message...'] })] }) : _jsxs(_Fragment, { children: [beforeCursor, _jsx(Text, { inverse: true, children: cursorChar }), afterCursor] })] })] });
+    const displayValue = mask ? '•'.repeat(value.length) : compactPasteBlocksForDisplay(value, pasteBlocks);
+    const displayCursor = mask ? cursor : displayCursorForValueCursor(pasteBlocks, cursor);
+    const beforeCursor = displayValue.slice(0, displayCursor);
+    const cursorChar = displayValue[displayCursor] ?? ' ';
+    const afterCursor = displayValue.slice(displayCursor + 1);
+    return _jsxs(Box, { flexDirection: "column", width: "100%", children: [filteredSuggestions.length > 0 && _jsx(Box, { flexDirection: "column", marginBottom: 1, children: filteredSuggestions.map((suggestion, index) => _jsxs(Text, { color: index === activeSuggestionIndex ? theme.success : theme.muted, wrap: "truncate-end", children: [index === activeSuggestionIndex ? '› ' : '  ', suggestion.value, _jsxs(Text, { color: theme.muted, children: [" ", suggestion.kind ?? 'command', suggestion.description ? ` — ${suggestion.description}` : ''] })] }, suggestion.value)) }), _jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { color: theme.purple, children: "\u203A " }), value.length === 0 ? _jsxs(_Fragment, { children: [_jsx(Text, { inverse: true, children: " " }), _jsxs(Text, { color: theme.muted, dimColor: true, children: [" ", placeholder ?? 'Type a message...'] })] }) : _jsxs(_Fragment, { children: [beforeCursor, _jsx(Text, { inverse: true, children: cursorChar }), afterCursor] })] })] });
 }

package/dist/ui/theme.d.ts

@@ -7,6 +7,7 @@ export declare const theme: {
     danger: string;
     success: string;
     warning: string;
+    orange: string;
     codeBg: string;
     quoteBg: string;
 };

package/dist/ui/theme.js

@@ -5,8 +5,9 @@ export const theme = {
     blue: '#60a5fa',
     muted: '#9ca3af',
     danger: '#fb7185',
-    success: '#34d399',
+    success: '#39ff14',
     warning: '#fbbf24',
+    orange: '#f59e0b',
     codeBg: '#1f1633',
     quoteBg: '#171127'
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@denizokcu/haze",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "A pragmatic agentic CLI for building apps from the terminal.",
   "type": "module",
   "license": "MIT",
@@ -44,15 +44,15 @@
   },
   "dependencies": {
     "@ai-sdk/openai": "3.0.67",
-    "@inquirer/prompts": "8.5.1",
-    "ai": "6.0.193",
+    "@inquirer/prompts": "8.5.2",
+    "ai": "6.0.194",
     "cli-highlight": "2.1.11",
     "commander": "15.0.0",
     "fs-extra": "11.3.5",
     "ink": "7.0.5",
     "ink-spinner": "5.0.0",
     "marked": "18.0.4",
-    "react": "19.2.6",
+    "react": "19.2.7",
     "strip-ansi": "7.2.0",
     "yaml": "2.9.0",
     "zod": "4.4.3"
@@ -61,11 +61,11 @@
     "@eslint/js": "^10.0.1",
     "@types/fs-extra": "11.0.4",
     "@types/node": "25.9.1",
-    "@types/react": "19.2.15",
+    "@types/react": "19.2.16",
     "eslint": "^10.4.1",
-    "tsx": "4.22.3",
+    "tsx": "4.22.4",
     "typescript": "6.0.3",
-    "typescript-eslint": "^8.60.0",
-    "vitest": "^4.1.7"
+    "typescript-eslint": "^8.60.1",
+    "vitest": "^4.1.8"
   }
 }