prompt-language-shell 0.3.6 → 0.3.8

package/README.md

@@ -45,6 +45,12 @@ Your configuration is stored in `~/.plsrc` as a YAML file. Supported settings:
 - `anthropic.key` - Your API key
 - `anthropic.model` - The model to use
 
+## Skills
+
+You can extend `pls` with custom workflows by creating markdown files in `~/.pls/skills/`. Skills define domain-specific operations, parameters, and steps that guide both planning and execution of tasks.
+
+Your skills are referenced when planning requests, enabling `pls` to understand specific workflows, create and execute structured plans tailored to your environment.
+
 ## Development
 
 See [CLAUDE.md](./CLAUDE.md) for development guidelines and architecture.

package/dist/index.js

@@ -20,6 +20,7 @@ const app = {
     version: packageJson.version,
     description: packageJson.description,
     isDev,
+    isDebug: false,
 };
 // Get command from command-line arguments
 const args = process.argv.slice(2);

package/dist/services/components.js

@@ -1,6 +1,7 @@
 import { randomUUID } from 'node:crypto';
 import { ComponentName } from '../types/types.js';
 import { AnthropicModel, isValidAnthropicApiKey, isValidAnthropicModel, } from './config.js';
+import { getConfirmationMessage } from './messages.js';
 import { StepType } from '../ui/Config.js';
 export function markAsDone(component) {
     return { ...component, state: { ...component.state, done: true } };
@@ -123,6 +124,18 @@ export function createRefinement(text, onAborted) {
         },
     };
 }
+export function createConfirmDefinition(onConfirmed, onCancelled) {
+    return {
+        id: randomUUID(),
+        name: ComponentName.Confirm,
+        state: { done: false },
+        props: {
+            message: getConfirmationMessage(),
+            onConfirmed,
+            onCancelled,
+        },
+    };
+}
 export function isStateless(component) {
     return !('state' in component);
 }

package/dist/services/config.js

@@ -50,6 +50,14 @@ function validateConfig(parsed) {
     if (model && typeof model === 'string' && isValidAnthropicModel(model)) {
         validatedConfig.anthropic.model = model;
     }
+    // Optional settings section
+    if (config.settings && typeof config.settings === 'object') {
+        const settings = config.settings;
+        validatedConfig.settings = {};
+        if ('debug' in settings && typeof settings.debug === 'boolean') {
+            validatedConfig.settings.debug = settings.debug;
+        }
+    }
     return validatedConfig;
 }
 export function loadConfig() {
@@ -116,6 +124,18 @@ export function saveConfig(section, config) {
 export function saveAnthropicConfig(config) {
     saveConfig('anthropic', config);
 }
+export function saveDebugSetting(debug) {
+    saveConfig('settings', { debug });
+}
+export function loadDebugSetting() {
+    try {
+        const config = loadConfig();
+        return config.settings?.debug ?? false;
+    }
+    catch {
+        return false;
+    }
+}
 /**
  * Returns a message requesting initial setup.
  * Provides natural language variations that sound like a professional concierge

package/dist/services/messages.js

@@ -0,0 +1,15 @@
+/**
+ * Returns a natural language confirmation message for plan execution.
+ * Randomly selects from variations to sound less robotic.
+ */
+export function getConfirmationMessage() {
+    const messages = [
+        'Should I execute this plan?',
+        'Do you want me to proceed with these tasks?',
+        'Ready to execute?',
+        'Shall I execute this plan?',
+        'Would you like me to run these tasks?',
+        'Execute this plan?',
+    ];
+    return messages[Math.floor(Math.random() * messages.length)];
+}

package/dist/types/types.js

@@ -7,6 +7,7 @@ export var ComponentName;
     ComponentName["Plan"] = "plan";
     ComponentName["Refinement"] = "refinement";
     ComponentName["Feedback"] = "feedback";
+    ComponentName["Confirm"] = "confirm";
 })(ComponentName || (ComponentName = {}));
 export var TaskType;
 (function (TaskType) {

package/dist/ui/Column.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { Box } from 'ink';
 import { Component } from './Component.js';
-export const Column = ({ items }) => {
-    return (_jsx(Box, { marginTop: 1, marginBottom: 1, marginLeft: 1, flexDirection: "column", gap: 1, children: items.map((item) => (_jsx(Box, { children: _jsx(Component, { def: item }) }, item.id))) }));
+export const Column = ({ items, debug }) => {
+    return (_jsx(Box, { marginTop: 1, marginBottom: 1, marginLeft: 1, flexDirection: "column", gap: 1, children: items.map((item) => (_jsx(Box, { children: _jsx(Component, { def: item, debug: debug }) }, item.id))) }));
 };

package/dist/ui/Component.js

@@ -1,13 +1,14 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { ComponentName } from '../types/types.js';
 import { Command } from './Command.js';
+import { Confirm } from './Confirm.js';
 import { Config } from './Config.js';
 import { Feedback } from './Feedback.js';
 import { Message } from './Message.js';
 import { Plan } from './Plan.js';
 import { Refinement } from './Refinement.js';
 import { Welcome } from './Welcome.js';
-export function Component({ def }) {
+export function Component({ def, debug }) {
     switch (def.name) {
         case ComponentName.Welcome:
             return _jsx(Welcome, { ...def.props });
@@ -22,7 +23,7 @@ export function Component({ def }) {
             return _jsx(Command, { ...props, state: state });
         }
         case ComponentName.Plan:
-            return _jsx(Plan, { ...def.props });
+            return _jsx(Plan, { ...def.props, debug: debug });
         case ComponentName.Feedback:
             return _jsx(Feedback, { ...def.props });
         case ComponentName.Message:
@@ -32,5 +33,10 @@ export function Component({ def }) {
             const state = def.state;
             return _jsx(Refinement, { ...props, state: state });
         }
+        case ComponentName.Confirm: {
+            const props = def.props;
+            const state = def.state;
+            return _jsx(Confirm, { ...props, state: state });
+        }
     }
 }

package/dist/ui/Confirm.js

@@ -0,0 +1,41 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from 'react';
+import { Box, Text, useInput } from 'ink';
+export function Confirm({ message, state, onConfirmed, onCancelled, }) {
+    const done = state?.done ?? false;
+    const [selectedIndex, setSelectedIndex] = React.useState(0); // 0 = Yes, 1 = No
+    useInput((input, key) => {
+        if (done)
+            return;
+        if (key.escape) {
+            // Escape: highlight "No" and cancel
+            setSelectedIndex(1);
+            onCancelled?.();
+        }
+        else if (key.tab) {
+            // Toggle between Yes (0) and No (1)
+            setSelectedIndex((prev) => (prev === 0 ? 1 : 0));
+        }
+        else if (key.return) {
+            // Confirm selection
+            if (selectedIndex === 0) {
+                onConfirmed?.();
+            }
+            else {
+                onCancelled?.();
+            }
+        }
+    }, { isActive: !done });
+    const options = [
+        { label: 'Yes', value: 'yes', color: '#4a9a7a' }, // green (execute)
+        { label: 'No', value: 'no', color: '#a85c3f' }, // dark orange (discard)
+    ];
+    if (done) {
+        // When done, show both the message and user's choice in timeline
+        return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { children: message }) }), _jsx(Box, { children: _jsxs(Text, { color: "gray", children: ["> ", options[selectedIndex].label] }) })] }));
+    }
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { children: message }) }), _jsxs(Box, { children: [_jsx(Text, { color: "#5c8cbc", children: ">" }), _jsx(Text, { children: " " }), _jsx(Box, { children: options.map((option, index) => {
+                            const isSelected = index === selectedIndex;
+                            return (_jsx(Box, { marginRight: 2, children: _jsx(Text, { color: isSelected ? option.color : undefined, dimColor: !isSelected, bold: isSelected, children: option.label }) }, option.value));
+                        }) })] })] }));
+}

package/dist/ui/Label.js

@@ -1,6 +1,6 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text } from 'ink';
 import { Separator } from './Separator.js';
-export function Label({ description, descriptionColor, type, typeColor, }) {
-    return (_jsxs(Box, { children: [_jsx(Text, { color: descriptionColor, children: description }), _jsx(Separator, {}), _jsx(Text, { color: typeColor, children: type })] }));
+export function Label({ description, descriptionColor, type, typeColor, showType = false, }) {
+    return (_jsxs(Box, { children: [_jsx(Text, { color: descriptionColor, children: description }), showType && (_jsxs(_Fragment, { children: [_jsx(Separator, {}), _jsx(Text, { color: typeColor, children: type })] }))] }));
 }

package/dist/ui/List.js

@@ -1,7 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text } from 'ink';
 import { Label } from './Label.js';
-export const List = ({ items, level = 0, highlightedIndex = null, highlightedParentIndex = null, }) => {
+export const List = ({ items, level = 0, highlightedIndex = null, highlightedParentIndex = null, showType = false, }) => {
     const marginLeft = level > 0 ? 4 : 0;
     return (_jsx(Box, { flexDirection: "column", marginLeft: marginLeft, children: items.map((item, index) => {
             // At level 0, track which parent is active for child highlighting
@@ -16,6 +16,11 @@ export const List = ({ items, level = 0, highlightedIndex = null, highlightedPar
             const typeColor = isHighlighted && item.type.highlightedColor
                 ? item.type.highlightedColor
                 : item.type.color;
-            return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { color: "whiteBright", children: marker }), _jsx(Label, { description: item.description.text, descriptionColor: descriptionColor, type: item.type.text, typeColor: typeColor })] }), item.children && item.children.length > 0 && (_jsx(List, { items: item.children, level: level + 1, highlightedIndex: shouldHighlightChildren ? highlightedIndex : null }))] }, index));
+            // Use highlighted type color for arrow markers when highlighted
+            const markerColor = item.markerColor ||
+                (isHighlighted && item.type.highlightedColor
+                    ? item.type.highlightedColor
+                    : 'whiteBright');
+            return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { color: markerColor, children: marker }), _jsx(Label, { description: item.description.text, descriptionColor: descriptionColor, type: item.type.text, typeColor: typeColor, showType: showType })] }), item.children && item.children.length > 0 && (_jsx(List, { items: item.children, level: level + 1, highlightedIndex: shouldHighlightChildren ? highlightedIndex : null, showType: showType }))] }, index));
         }) }));
 };

package/dist/ui/Main.js

@@ -1,9 +1,10 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import React from 'react';
+import { useInput } from 'ink';
 import { ComponentName, FeedbackType, TaskType, } from '../types/types.js';
 import { createAnthropicService, } from '../services/anthropic.js';
-import { getConfigurationRequiredMessage, hasValidAnthropicKey, loadConfig, saveAnthropicConfig, } from '../services/config.js';
-import { createCommandDefinition, createConfigDefinition, createFeedback, createMessage, createRefinement, createPlanDefinition, createWelcomeDefinition, getRefiningMessage, isStateless, markAsDone, } from '../services/components.js';
+import { getConfigurationRequiredMessage, hasValidAnthropicKey, loadConfig, loadDebugSetting, saveAnthropicConfig, saveDebugSetting, } from '../services/config.js';
+import { createCommandDefinition, createConfirmDefinition, createConfigDefinition, createFeedback, createMessage, createRefinement, createPlanDefinition, createWelcomeDefinition, getRefiningMessage, isStateless, markAsDone, } from '../services/components.js';
 import { exitApp } from '../services/process.js';
 import { Column } from './Column.js';
 export const Main = ({ app, command }) => {
@@ -17,6 +18,18 @@ export const Main = ({ app, command }) => {
     });
     const [timeline, setTimeline] = React.useState([]);
     const [queue, setQueue] = React.useState([]);
+    const [isDebug, setIsDebug] = React.useState(() => loadDebugSetting());
+    // Top-level Shift+Tab handler for debug mode toggle
+    // Child components must ignore Shift+Tab to prevent conflicts
+    useInput((input, key) => {
+        if (key.shift && key.tab) {
+            setIsDebug((prev) => {
+                const newValue = !prev;
+                saveDebugSetting(newValue);
+                return newValue;
+            });
+        }
+    }, { isActive: true });
     const addToTimeline = React.useCallback((...items) => {
         setTimeline((timeline) => [...timeline, ...items]);
     }, []);
@@ -69,6 +82,30 @@ export const Main = ({ app, command }) => {
     const handleRefinementAborted = React.useCallback(() => {
         handleAborted('Plan refinement');
     }, [handleAborted]);
+    const handleExecutionConfirmed = React.useCallback(() => {
+        setQueue((currentQueue) => {
+            if (currentQueue.length === 0)
+                return currentQueue;
+            const [first] = currentQueue;
+            if (first.name === ComponentName.Confirm) {
+                addToTimeline(markAsDone(first));
+            }
+            exitApp(0);
+            return [];
+        });
+    }, [addToTimeline]);
+    const handleExecutionCancelled = React.useCallback(() => {
+        setQueue((currentQueue) => {
+            if (currentQueue.length === 0)
+                return currentQueue;
+            const [first] = currentQueue;
+            if (first.name === ComponentName.Confirm) {
+                addToTimeline(markAsDone(first), createFeedback(FeedbackType.Aborted, 'Execution cancelled'));
+            }
+            exitApp(0);
+            return [];
+        });
+    }, [addToTimeline]);
     const handlePlanSelectionConfirmed = React.useCallback(async (selectedTasks) => {
         // Mark current plan as done and add refinement to queue
         let refinementDef = null;
@@ -101,10 +138,11 @@ export const Main = ({ app, command }) => {
                 }
                 return [];
             });
-            // Show final execution plan
+            // Show final execution plan with confirmation
             const planDefinition = createPlanDefinition(result.message, result.tasks, handlePlanAborted, undefined);
+            const confirmDefinition = createConfirmDefinition(handleExecutionConfirmed, handleExecutionCancelled);
             addToTimeline(planDefinition);
-            exitApp(0);
+            setQueue([confirmDefinition]);
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
@@ -135,16 +173,21 @@ export const Main = ({ app, command }) => {
                     return [planDefinition];
                 }
                 else {
-                    // No define task - add plan to timeline and exit
+                    // No define task - show plan and confirmation
+                    const confirmDefinition = createConfirmDefinition(handleExecutionConfirmed, handleExecutionCancelled);
                     addToTimeline(markAsDone(first), planDefinition);
-                    exitApp(0);
-                    return [];
+                    return [confirmDefinition];
                 }
             }
             exitApp(0);
             return [];
         });
-    }, [addToTimeline, handlePlanSelectionConfirmed]);
+    }, [
+        addToTimeline,
+        handlePlanSelectionConfirmed,
+        handleExecutionConfirmed,
+        handleExecutionCancelled,
+    ]);
     const handleConfigFinished = React.useCallback((config) => {
         const anthropicConfig = config;
         saveAnthropicConfig(anthropicConfig);
@@ -203,7 +246,13 @@ export const Main = ({ app, command }) => {
     React.useEffect(() => {
         processNextInQueue();
     }, [queue, processNextInQueue]);
+    // Exit when queue is empty and timeline has content (all stateless components done)
+    React.useEffect(() => {
+        if (queue.length === 0 && timeline.length > 0) {
+            exitApp(0);
+        }
+    }, [queue, timeline]);
     const current = queue.length > 0 ? queue[0] : null;
     const items = [...timeline, ...(current ? [current] : [])];
-    return _jsx(Column, { items: items });
+    return _jsx(Column, { items: items, debug: isDebug });
 };

package/dist/ui/Plan.js

@@ -54,6 +54,7 @@ function taskToListItem(task, highlightedChildIndex = null, isDefineTaskWithoutS
     // Mark define tasks with right arrow when no selection has been made
     if (isDefineTaskWithoutSelection) {
         item.marker = '  → ';
+        item.markerColor = ColorPalette[TaskType.Plan].type;
     }
     // Add children for Define tasks with options
     if (task.type === TaskType.Define && Array.isArray(task.params?.options)) {
@@ -82,7 +83,7 @@ function taskToListItem(task, highlightedChildIndex = null, isDefineTaskWithoutS
     }
     return item;
 }
-export function Plan({ message, tasks, state, onSelectionConfirmed, onAborted, }) {
+export function Plan({ message, tasks, state, debug = false, onSelectionConfirmed, onAborted, }) {
     const [highlightedIndex, setHighlightedIndex] = useState(state?.highlightedIndex ?? null);
     const [currentDefineGroupIndex, setCurrentDefineGroupIndex] = useState(state?.currentDefineGroupIndex ?? 0);
     const [completedSelections, setCompletedSelections] = useState(state?.completedSelections ?? []);
@@ -208,5 +209,5 @@ export function Plan({ message, tasks, state, onSelectionConfirmed, onAborted, }
             !isDone;
         return taskToListItem(task, childIndex, isDefineWithoutSelection);
     });
-    return (_jsxs(Box, { flexDirection: "column", children: [message && (_jsx(Box, { marginBottom: 1, children: _jsx(Label, { description: message, descriptionColor: ColorPalette[TaskType.Plan].description, type: TaskType.Plan, typeColor: ColorPalette[TaskType.Plan].type }) })), _jsx(List, { items: listItems, highlightedIndex: currentDefineTaskIndex >= 0 ? highlightedIndex : null, highlightedParentIndex: currentDefineTaskIndex })] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [message && (_jsx(Box, { marginBottom: 1, children: _jsx(Label, { description: message, descriptionColor: ColorPalette[TaskType.Plan].description, type: TaskType.Plan, typeColor: ColorPalette[TaskType.Plan].type, showType: debug }) })), _jsx(List, { items: listItems, highlightedIndex: currentDefineTaskIndex >= 0 ? highlightedIndex : null, highlightedParentIndex: currentDefineTaskIndex, showType: debug })] }));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prompt-language-shell",
-  "version": "0.3.6",
+  "version": "0.3.8",
   "description": "Your personal command-line concierge. Ask politely, and it gets things done.",
   "type": "module",
   "main": "dist/index.js",