@denizokcu/haze 0.0.1 → 0.0.3

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

@@ -1,9 +1,20 @@
-export declare function TextInput({ placeholder, disabled, mask, historyItems, recordHistory, onHistoryAdd, onSubmit }: {
+import React from 'react';
+export type TextInputSuggestion = {
+    value: string;
+    description?: string;
+    kind?: 'command' | 'skill' | 'provider' | 'model';
+};
+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

@@ -1,13 +1,64 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
 import { useEffect, useRef, useState } from 'react';
-import { Text, useInput } from 'ink';
+import { Box, Text, useInput } from 'ink';
 import { theme } from '../theme.js';
-export function TextInput({ placeholder, disabled, mask, historyItems = [], recordHistory = true, onHistoryAdd, 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,40 +66,83 @@ 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 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 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);
+    }
     useInput((input, key) => {
-        if (disabled)
+        if (disabled) {
+            if (key.escape)
+                onCancel?.();
             return;
+        }
         if (key.escape) {
             setInput('');
             historyIndex.current = null;
             draft.current = '';
+            nextPasteId.current = 1;
+            onEscape?.();
+            return;
+        }
+        if (key.tab && activeSuggestion) {
+            setInput(activeSuggestion.value);
+            historyIndex.current = null;
             return;
         }
         if (key.return) {
-            const submitted = 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) {
-                if (recordHistory) {
-                    if (history.current[history.current.length - 1] !== submitted)
-                        history.current = [...history.current, submitted];
-                    onHistoryAdd?.(submitted);
-                }
-                onSubmit(submitted);
-            }
+            nextPasteId.current = 1;
+            if (submitted || submitOnEmpty)
+                submitValue(submitted, historyValue);
             return;
         }
         if (key.leftArrow) {
@@ -60,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) {
@@ -72,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) {
@@ -86,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') {
@@ -108,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(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, 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

@@ -2,10 +2,12 @@ export declare const theme: {
     purple: string;
     deepPurple: string;
     violet: string;
+    blue: string;
     muted: string;
     danger: string;
     success: string;
     warning: string;
+    orange: string;
     codeBg: string;
     quoteBg: string;
 };

package/dist/ui/theme.js

@@ -2,10 +2,12 @@ export const theme = {
     purple: '#a78bfa',
     deepPurple: '#6d28d9',
     violet: '#8b5cf6',
+    blue: '#60a5fa',
     muted: '#9ca3af',
     danger: '#fb7185',
-    success: '#34d399',
+    success: '#39ff14',
     warning: '#fbbf24',
+    orange: '#f59e0b',
     codeBg: '#1f1633',
     quoteBg: '#171127'
 };

package/dist/utils/fs.d.ts

@@ -8,6 +8,7 @@ export interface WalkEntry {
 export interface WalkOptions {
     recursive?: boolean;
     maxEntries?: number;
+    cursor?: string;
     filter?: (entry: WalkEntry) => boolean | Promise<boolean>;
 }
 export declare function walkDir(root: string, options?: WalkOptions): Promise<WalkEntry[]>;

package/dist/utils/fs.js

@@ -2,10 +2,12 @@ import fs from 'fs-extra';
 import path from 'node:path';
 const SKIP_ENTRIES = new Set(['node_modules', '.git']);
 export async function walkDir(root, options = {}) {
-    const { recursive = false, maxEntries = Infinity, filter } = options;
+    const { recursive = false, maxEntries = Infinity, cursor, filter } = options;
     const result = [];
+    let cursorSeen = cursor == null;
     async function walk(dir) {
-        for (const entry of await fs.readdir(dir, { withFileTypes: true })) {
+        const entries = (await fs.readdir(dir, { withFileTypes: true })).sort((a, b) => a.name.localeCompare(b.name));
+        for (const entry of entries) {
             if (result.length >= maxEntries)
                 return;
             if (SKIP_ENTRIES.has(entry.name))
@@ -19,10 +21,12 @@ export async function walkDir(root, options = {}) {
                 isDirectory: entry.isDirectory(),
                 isFile: entry.isFile(),
             };
-            if (filter && !await filter(walkEntry))
-                continue;
-            result.push(walkEntry);
-            if (entry.isDirectory() && recursive)
+            const passesFilter = !filter || await filter(walkEntry);
+            if (passesFilter && cursorSeen)
+                result.push(walkEntry);
+            if (passesFilter && !cursorSeen && relativePath === cursor)
+                cursorSeen = true;
+            if (entry.isDirectory() && recursive && (!filter || passesFilter))
                 await walk(absolutePath);
         }
     }

package/examples/skills/files/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: files
+description: Use when the user asks for a careful file-inspection or file-editing workflow.
+---
+
+Use Haze's built-in file tools rather than shell commands for file discovery and edits.
+
+Workflow:
+1. Use `listFiles` for project discovery.
+2. Use `readFile` before editing existing files.
+3. Prefer `editFile` for small exact changes.
+4. Use `replaceLines` when exact replacement is ambiguous.
+5. Use `writeFile` only for new files or intentional complete rewrites.
+
+References:
+- examples/file-editing.md

package/examples/skills/files/examples/file-editing.md

@@ -0,0 +1,3 @@
+# File editing example
+
+When changing existing files, inspect the current contents first, make the smallest targeted edit, then run the relevant validation command when practical.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@denizokcu/haze",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "A pragmatic agentic CLI for building apps from the terminal.",
   "type": "module",
   "license": "MIT",
@@ -19,7 +19,7 @@
     "node": ">=20"
   },
   "bin": {
-    "haze": "./bin/haze.js"
+    "haze": "bin/haze.js"
   },
   "files": [
     "bin",
@@ -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"
   }
 }

package/dist/skills/installer/SkillInstaller.d.ts

@@ -1 +0,0 @@
-export declare function installSkill(spec: string): Promise<void>;

package/dist/skills/installer/SkillInstaller.js

@@ -1,48 +0,0 @@
-import fs from 'fs-extra';
-import os from 'node:os';
-import path from 'node:path';
-import { spawnSync } from 'node:child_process';
-import { confirm } from '@inquirer/prompts';
-import { GLOBAL_SKILLS_DIR } from '../../config/paths.js';
-import { loadSkill } from '../SkillLoader.js';
-import { listFilesRecursive } from '../../utils/fs.js';
-function repoUrl(spec) {
-    if (spec.startsWith('http'))
-        return spec;
-    if (spec.startsWith('github:'))
-        return `https://github.com/${spec.slice(7)}.git`;
-    if (/^[\w.-]+\/[\w.-]+$/.test(spec))
-        return `https://github.com/${spec}.git`;
-    return spec;
-}
-export async function installSkill(spec) {
-    const tmp = await fs.mkdtemp(path.join(os.tmpdir(), 'haze-skill-'));
-    const url = repoUrl(spec);
-    const clone = spawnSync('git', ['clone', '--depth=1', url, tmp], { stdio: 'inherit' });
-    if (clone.status !== 0)
-        throw new Error('git clone failed');
-    const skill = await loadSkill(tmp, 'global');
-    if (!skill)
-        throw new Error('Repository does not contain a root skill.yaml');
-    console.log(`\nSkill: ${skill.manifest.name} ${skill.manifest.version}`);
-    console.log(skill.manifest.description);
-    console.log('\nFiles:');
-    for (const f of await listFilesRecursive(tmp))
-        console.log(`  ${f}`);
-    const deps = skill.manifest.dependencies;
-    if (deps?.cli?.length)
-        console.log(`\nCLI dependencies: ${deps.cli.map(d => d.name).join(', ')}`);
-    if (deps?.env?.length)
-        console.log(`Env dependencies: ${deps.env.map(d => d.name).join(', ')}`);
-    const dest = path.join(GLOBAL_SKILLS_DIR, skill.manifest.name);
-    if (await fs.pathExists(dest))
-        console.log(`\nExisting skill will be replaced: ${dest}`);
-    const ok = await confirm({ message: 'Approve and activate this skill? It is code from the internet, regrettably.', default: false });
-    if (!ok)
-        return;
-    await fs.remove(dest);
-    await fs.ensureDir(path.dirname(dest));
-    await fs.copy(tmp, dest, { filter: src => !src.includes(`${path.sep}.git${path.sep}`) });
-    await fs.remove(path.join(dest, '.git'));
-    console.log(`Installed ${skill.manifest.name} to ${dest}`);
-}

package/dist/skills/manifestSchema.d.ts

@@ -1,31 +0,0 @@
-import { z } from 'zod';
-export declare const skillManifestSchema: z.ZodObject<{
-    name: z.ZodString;
-    version: z.ZodString;
-    description: z.ZodString;
-    author: z.ZodOptional<z.ZodString>;
-    homepage: z.ZodOptional<z.ZodString>;
-    dependencies: z.ZodOptional<z.ZodObject<{
-        cli: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            name: z.ZodString;
-            description: z.ZodOptional<z.ZodString>;
-            required: z.ZodOptional<z.ZodBoolean>;
-        }, z.core.$strip>>>;
-        env: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            name: z.ZodString;
-            description: z.ZodOptional<z.ZodString>;
-            required: z.ZodOptional<z.ZodBoolean>;
-        }, z.core.$strip>>>;
-    }, z.core.$strip>>;
-    tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        name: z.ZodString;
-        description: z.ZodString;
-        path: z.ZodString;
-        input: z.ZodOptional<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
-    }, z.core.$strip>>>;
-    prompts: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        name: z.ZodString;
-        description: z.ZodOptional<z.ZodString>;
-        path: z.ZodString;
-    }, z.core.$strip>>>;
-}, z.core.$strip>;

package/dist/skills/manifestSchema.js

@@ -1,23 +0,0 @@
-import { z } from 'zod';
-const jsonSchema = z.lazy(() => z.object({
-    type: z.string().optional(),
-    required: z.array(z.string()).optional(),
-    properties: z.record(z.string(), jsonSchema).optional(),
-    items: jsonSchema.optional(),
-    description: z.string().optional(),
-    enum: z.array(z.unknown()).optional(),
-    additionalProperties: z.union([z.boolean(), jsonSchema]).optional()
-}).passthrough());
-export const skillManifestSchema = z.object({
-    name: z.string().min(1).regex(/^[a-zA-Z0-9_-]+$/),
-    version: z.string().min(1),
-    description: z.string().min(1),
-    author: z.string().optional(),
-    homepage: z.string().url().optional(),
-    dependencies: z.object({
-        cli: z.array(z.object({ name: z.string(), description: z.string().optional(), required: z.boolean().optional() })).optional(),
-        env: z.array(z.object({ name: z.string(), description: z.string().optional(), required: z.boolean().optional() })).optional()
-    }).optional(),
-    tools: z.array(z.object({ name: z.string().min(1), description: z.string().min(1), path: z.string().min(1), input: jsonSchema.optional() })).optional(),
-    prompts: z.array(z.object({ name: z.string().min(1), description: z.string().optional(), path: z.string().min(1) })).optional(),
-});

package/dist/tools/ToolExecutor.d.ts

@@ -1,3 +0,0 @@
-import type { LoadedSkill, LoadedTool } from '../skills/types.js';
-import type { ToolResult } from './types.js';
-export declare function executeTool(tool: LoadedTool, skill: LoadedSkill, input: Record<string, unknown>): Promise<ToolResult>;

package/dist/tools/ToolExecutor.js

@@ -1,15 +0,0 @@
-import { pathToFileURL } from 'node:url';
-export async function executeTool(tool, skill, input) {
-    try {
-        const context = { cwd: process.cwd(), skillDir: skill.dir };
-        const mod = await import(`${pathToFileURL(tool.absolutePath).href}?t=${Date.now()}`);
-        if (typeof mod.execute !== 'function') {
-            return { ok: false, message: 'Tool must export execute(input, context)' };
-        }
-        const result = await mod.execute(input ?? {}, context);
-        return result ?? { ok: true };
-    }
-    catch (error) {
-        return { ok: false, message: error instanceof Error ? error.message : String(error) };
-    }
-}

package/dist/tools/types.d.ts

@@ -1,9 +0,0 @@
-export interface ToolContext {
-    cwd: string;
-    skillDir: string;
-}
-export interface ToolResult {
-    ok: boolean;
-    message?: string;
-    data?: unknown;
-}

package/dist/tools/types.js

@@ -1 +0,0 @@
-export {};

package/examples/skills/files/prompts/file_tasks.md

@@ -1 +0,0 @@
-For file tasks, prefer listing files before reading unknown paths. Never ask to read secrets unless the user explicitly requests it.

package/examples/skills/files/skill.yaml

@@ -1,28 +0,0 @@
-name: files
-version: 0.1.0
-description: Safe-ish file inspection tools for the current project.
-dependencies: {}
-tools:
-  - name: list_files
-    description: List files under a directory in the current project. Skips .git and node_modules.
-    path: tools/list_files.ts
-    input:
-      type: object
-      properties:
-        dir:
-          type: string
-          description: Directory to list, relative to the current working directory.
-  - name: read_file
-    description: Read a UTF-8 text file from the current project.
-    path: tools/read_file.ts
-    input:
-      type: object
-      required: [path]
-      properties:
-        path:
-          type: string
-          description: File path relative to the current working directory.
-prompts:
-  - name: file_tasks
-    description: Guidance for file inspection tasks.
-    path: prompts/file_tasks.md

package/examples/skills/files/tools/list_files.ts

@@ -1,21 +0,0 @@
-import fs from 'node:fs/promises';
-import path from 'node:path';
-
-export async function execute(input: {dir?: string}, context: {cwd: string}) {
-  const root = path.resolve(context.cwd, input.dir ?? '.');
-  if (!root.startsWith(context.cwd)) return {ok: false, message: 'Refusing to list outside the current project.'};
-  const files: string[] = [];
-  async function walk(dir: string) {
-    for (const entry of await fs.readdir(dir)) {
-      if (entry === '.git' || entry === 'node_modules' || entry === 'dist') continue;
-      const full = path.join(dir, entry);
-      const rel = path.relative(context.cwd, full);
-      const stat = await fs.stat(full);
-      if (stat.isDirectory()) await walk(full);
-      else files.push(rel);
-      if (files.length >= 500) return;
-    }
-  }
-  await walk(root);
-  return {ok: true, message: `Found ${files.length} files.`, data: files.sort()};
-}

package/examples/skills/files/tools/read_file.ts

@@ -1,12 +0,0 @@
-import fs from 'node:fs/promises';
-import path from 'node:path';
-
-export async function execute(input: {path: string}, context: {cwd: string}) {
-  if (!input.path) return {ok: false, message: 'Missing path.'};
-  const full = path.resolve(context.cwd, input.path);
-  if (!full.startsWith(context.cwd)) return {ok: false, message: 'Refusing to read outside the current project.'};
-  const stat = await fs.stat(full);
-  if (!stat.isFile()) return {ok: false, message: 'Path is not a file.'};
-  if (stat.size > 200_000) return {ok: false, message: 'File is too large for the intentionally tiny attention span.'};
-  return {ok: true, message: `Read ${input.path}.`, data: await fs.readFile(full, 'utf8')};
-}