prompt-language-shell 0.6.8 → 0.7.2

package/dist/index.js

@@ -4,6 +4,7 @@ import { existsSync, readFileSync } from 'fs';
 import { dirname, join } from 'path';
 import { fileURLToPath } from 'url';
 import { render } from 'ink';
+import { DebugLevel } from './services/configuration.js';
 import { Main } from './ui/Main.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -20,7 +21,7 @@ const app = {
     version: packageJson.version,
     description: packageJson.description,
     isDev,
-    isDebug: false,
+    debug: DebugLevel.None,
 };
 // Get command from command-line arguments
 const args = process.argv.slice(2);

package/dist/services/anthropic.js

@@ -1,5 +1,6 @@
 import Anthropic from '@anthropic-ai/sdk';
 import { getAvailableConfigStructure, getConfiguredKeys, } from './configuration.js';
+import { logPrompt, logResponse } from './logger.js';
 import { formatSkillsForPrompt, loadSkillsWithValidation } from './skills.js';
 import { toolRegistry } from './registry.js';
 /**
@@ -67,10 +68,10 @@ export class AnthropicService {
             systemPrompt += skillsSection;
         }
         // Add config structure for config tool only
-        if (toolName === 'config') {
+        if (toolName === 'configure') {
             const configStructure = getAvailableConfigStructure();
             const configuredKeys = getConfiguredKeys();
-            const configSection = '\n\n## Available Configuration\n\n' +
+            const configSection = '\n## Available Configuration\n\n' +
                 'Config structure (key: description):\n' +
                 JSON.stringify(configStructure, null, 2) +
                 '\n\nConfigured keys (keys that exist in config file):\n' +
@@ -85,7 +86,15 @@ export class AnthropicService {
                 name: 'web_search',
             });
         }
+        // Collect debug components
+        const debug = [];
+        // Log prompt at Verbose level
+        const promptDebug = logPrompt(toolName, command, systemPrompt);
+        if (promptDebug) {
+            debug.push(promptDebug);
+        }
         // Call API with tool
+        const startTime = Date.now();
         const response = await this.client.messages.create({
             model: this.model,
             max_tokens: 1024,
@@ -99,6 +108,12 @@ export class AnthropicService {
                 },
             ],
         });
+        const duration = Date.now() - startTime;
+        // Log response at Verbose level
+        const responseDebug = logResponse(toolName, response, duration);
+        if (responseDebug) {
+            debug.push(responseDebug);
+        }
         // Check for truncation
         if (response.stop_reason === 'max_tokens') {
             throw new Error('Response was truncated due to length. Please simplify your request or break it into smaller parts.');
@@ -113,6 +128,7 @@ export class AnthropicService {
                     message: '',
                     tasks: [],
                     answer: cleanAnswerText(textContent.text),
+                    debug,
                 };
             }
         }
@@ -143,6 +159,7 @@ export class AnthropicService {
                 message: input.message,
                 tasks: [],
                 commands: input.commands,
+                debug,
             };
         }
         // Handle answer tool response
@@ -157,6 +174,7 @@ export class AnthropicService {
                 message: '',
                 tasks: [],
                 answer: cleanAnswerText(input.answer),
+                debug,
             };
         }
         // Handle plan and introspect tool responses
@@ -175,6 +193,7 @@ export class AnthropicService {
         return {
             message: input.message,
             tasks: input.tasks,
+            debug,
         };
     }
 }

package/dist/services/colors.js

@@ -1,4 +1,5 @@
 import { FeedbackType, TaskType } from '../types/types.js';
+import { DebugLevel } from './configuration.js';
 /**
  * Base color palette - raw color values with descriptive names.
  * All colors used in the interface are defined here.
@@ -174,3 +175,32 @@ export function getFeedbackColor(type, isCurrent) {
 export function getTextColor(isCurrent) {
     return isCurrent ? Colors.Text.Active : Colors.Text.Inactive;
 }
+/**
+ * Verbose task type labels - two-word descriptions that start with the same
+ * keyword as the short version
+ */
+const verboseTaskTypeLabels = {
+    [TaskType.Config]: 'configure option',
+    [TaskType.Plan]: 'plan tasks',
+    [TaskType.Execute]: 'execute command',
+    [TaskType.Answer]: 'answer question',
+    [TaskType.Introspect]: 'introspect capabilities',
+    [TaskType.Report]: 'report results',
+    [TaskType.Define]: 'define options',
+    [TaskType.Ignore]: 'ignore request',
+    [TaskType.Select]: 'select option',
+    [TaskType.Discard]: 'discard option',
+};
+/**
+ * Get task type label based on debug level.
+ *
+ * Returns:
+ * - Verbose label (2 words) in verbose mode
+ * - Short label (1 word) in info mode or when debug is off
+ */
+export function getTaskTypeLabel(type, debug) {
+    if (debug === DebugLevel.Verbose) {
+        return verboseTaskTypeLabels[type];
+    }
+    return type;
+}

package/dist/services/components.js

@@ -252,6 +252,17 @@ export function createMessage(text) {
         },
     };
 }
+export function createDebugDefinition(title, content, color) {
+    return {
+        id: randomUUID(),
+        name: ComponentName.Debug,
+        props: {
+            title,
+            content,
+            color,
+        },
+    };
+}
 export function createRefinement(text, onAborted) {
     return {
         id: randomUUID(),

package/dist/services/configuration.js

@@ -9,6 +9,13 @@ export var AnthropicModel;
     AnthropicModel["Opus"] = "claude-opus-4-1";
 })(AnthropicModel || (AnthropicModel = {}));
 export const SUPPORTED_MODELS = Object.values(AnthropicModel);
+export var DebugLevel;
+(function (DebugLevel) {
+    DebugLevel["None"] = "none";
+    DebugLevel["Info"] = "info";
+    DebugLevel["Verbose"] = "verbose";
+})(DebugLevel || (DebugLevel = {}));
+export const SUPPORTED_DEBUG_LEVELS = Object.values(DebugLevel);
 export var ConfigDefinitionType;
 (function (ConfigDefinitionType) {
     ConfigDefinitionType["RegExp"] = "regexp";
@@ -62,8 +69,17 @@ function validateConfig(parsed) {
     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;
+        if ('debug' in settings) {
+            // Handle migration from boolean to enum
+            if (typeof settings.debug === 'boolean') {
+                validatedConfig.settings.debug = settings.debug
+                    ? DebugLevel.Info
+                    : DebugLevel.None;
+            }
+            else if (typeof settings.debug === 'string' &&
+                SUPPORTED_DEBUG_LEVELS.includes(settings.debug)) {
+                validatedConfig.settings.debug = settings.debug;
+            }
         }
     }
     return validatedConfig;
@@ -139,10 +155,10 @@ export function saveDebugSetting(debug) {
 export function loadDebugSetting() {
     try {
         const config = loadConfig();
-        return config.settings?.debug ?? false;
+        return config.settings?.debug ?? DebugLevel.None;
     }
     catch {
-        return false;
+        return DebugLevel.None;
     }
 }
 /**
@@ -193,8 +209,10 @@ const coreConfigSchema = {
         description: 'Anthropic model',
     },
     'settings.debug': {
-        type: ConfigDefinitionType.Boolean,
+        type: ConfigDefinitionType.Enum,
         required: false,
+        values: SUPPORTED_DEBUG_LEVELS,
+        default: DebugLevel.None,
         description: 'Debug mode',
     },
 };

package/dist/services/logger.js

@@ -0,0 +1,64 @@
+import { createDebugDefinition } from './components.js';
+import { DebugLevel, loadDebugSetting } from './configuration.js';
+import { Palette } from './colors.js';
+/**
+ * Debug logger for the application
+ * Logs information based on the current debug level setting
+ */
+let currentDebugLevel = DebugLevel.None;
+/**
+ * Initialize the logger with the current debug level from config
+ */
+export function initializeLogger() {
+    currentDebugLevel = loadDebugSetting();
+}
+/**
+ * Set the debug level (used for testing or runtime changes)
+ */
+export function setDebugLevel(debug) {
+    currentDebugLevel = debug;
+}
+/**
+ * Get the current debug level
+ */
+export function getDebugLevel() {
+    return currentDebugLevel;
+}
+/**
+ * Create debug component for system prompts sent to the LLM
+ * Only creates at Verbose level
+ */
+export function logPrompt(toolName, command, instructions) {
+    if (currentDebugLevel !== DebugLevel.Verbose) {
+        return null;
+    }
+    const content = [
+        '',
+        `Tool: ${toolName}`,
+        `Command: ${command}`,
+        '',
+        instructions,
+    ].join('\n');
+    // Calculate stats for the instructions
+    const lines = instructions.split('\n').length;
+    const bytes = Buffer.byteLength(instructions, 'utf-8');
+    const title = `SYSTEM PROMPT (${String(lines)} lines, ${String(bytes)} bytes)`;
+    return createDebugDefinition(title, content, Palette.Gray);
+}
+/**
+ * Create debug component for LLM responses received
+ * Only creates at Verbose level
+ */
+export function logResponse(toolName, response, durationMs) {
+    if (currentDebugLevel !== DebugLevel.Verbose) {
+        return null;
+    }
+    const content = [
+        '',
+        `Tool: ${toolName}`,
+        '',
+        JSON.stringify(response, null, 2),
+    ].join('\n');
+    const title = `LLM RESPONSE (${String(durationMs)} ms)`;
+    return createDebugDefinition(title, content, Palette.AshGray);
+}

package/dist/services/messages.js

@@ -1,4 +1,4 @@
-import { loadDebugSetting } from './configuration.js';
+import { DebugLevel, loadDebugSetting } from './configuration.js';
 export { formatDuration } from './utils.js';
 /**
  * Returns a natural language confirmation message for plan execution.
@@ -96,7 +96,7 @@ export const FeedbackMessages = {
  */
 export function formatErrorMessage(error) {
     const rawMessage = error instanceof Error ? error.message : 'Unknown error occurred';
-    if (loadDebugSetting()) {
+    if (loadDebugSetting() !== DebugLevel.None) {
         return rawMessage;
     }
     // Try to extract message from Anthropic API error format

package/dist/services/refinement.js

@@ -24,6 +24,10 @@ export async function handleRefinement(selectedTasks, service, originalCommand,
         const refinedResult = await service.processWithTool(refinedCommand, 'plan');
         // Complete the Refinement component
         handlers.completeActive();
+        // Add debug components to timeline if present
+        if (refinedResult.debug && refinedResult.debug.length > 0) {
+            handlers.addToTimeline(...refinedResult.debug);
+        }
         // Route refined tasks to appropriate components
         routeTasksWithConfirm(refinedResult.tasks, refinedResult.message, service, originalCommand, handlers, false // No DEFINE tasks in refined result
         );

package/dist/services/registry.js

@@ -34,14 +34,14 @@ class ToolRegistry {
 export const toolRegistry = new ToolRegistry();
 // Register built-in tools
 import { answerTool } from '../tools/answer.tool.js';
-import { configTool } from '../tools/config.tool.js';
+import { configureTool } from '../tools/configure.tool.js';
 import { executeTool } from '../tools/execute.tool.js';
 import { introspectTool } from '../tools/introspect.tool.js';
 import { planTool } from '../tools/plan.tool.js';
 import { validateTool } from '../tools/validate.tool.js';
 const tools = {
     answer: answerTool,
-    config: configTool,
+    configure: configureTool,
     execute: executeTool,
     introspect: introspectTool,
     plan: planTool,

package/dist/services/router.js

@@ -102,7 +102,7 @@ function executeTasksAfterConfirm(tasks, service, userRequest, handlers) {
             .map((task) => task.params?.key)
             .filter((key) => key !== undefined);
         handlers.addToQueue(createConfigDefinitionWithKeys(configKeys, (config) => {
-            // Save config using the same pattern as Validate component
+            // Save config - Config component will handle completion and feedback
             try {
                 // Convert flat dotted keys to nested structure grouped by section
                 const configBySection = unflattenConfig(config);
@@ -110,14 +110,12 @@ function executeTasksAfterConfirm(tasks, service, userRequest, handlers) {
                 for (const [section, sectionConfig] of Object.entries(configBySection)) {
                     saveConfig(section, sectionConfig);
                 }
-                handlers.completeActive();
-                handlers.addToQueue(createFeedback(FeedbackType.Succeeded, 'Configuration updated successfully.'));
             }
             catch (error) {
                 const errorMessage = error instanceof Error
                     ? error.message
                     : 'Failed to save configuration';
-                handlers.onError(errorMessage);
+                throw new Error(errorMessage);
             }
         }, (operation) => {
             handlers.onAborted(operation);

package/dist/services/skills.js

@@ -131,7 +131,6 @@ export function formatSkillsForPrompt(skills) {
         return '';
     }
     const header = `
-
 ## Available Skills
 
 The following skills define domain-specific workflows. When the user's
@@ -147,7 +146,7 @@ brackets for additional information. Use commas instead. For example:
 - WRONG: "Build project Alpha (the legacy version)"
 
 `;
-    const skillsContent = skills.join('\n\n');
+    const skillsContent = skills.map((s) => s.trim()).join('\n\n');
     return header + skillsContent;
 }
 /**

package/dist/skills/answer.md

@@ -5,9 +5,9 @@ command-line concierge. Your role is to **answer questions** and provide
 up-to-date information when a task with type "answer" has been planned and
 confirmed.
 
-**IMPORTANT**: Use web search to find current, accurate information. This tool
-is designed for quick answers from the terminal without needing to open a web
-browser. Always search for the latest data rather than relying solely on
+**IMPORTANT**: Use web search to find current, accurate information. This
+tool is designed for quick answers from the terminal without needing to open a
+web browser. Always search for the latest data rather than relying solely on
 training data.
 
 ## Execution Flow
@@ -60,11 +60,11 @@ TypeScript code compiles to JavaScript and runs anywhere JavaScript runs.
 
 Bad answer (too verbose):
 ```
-TypeScript is a strongly typed programming language that builds on JavaScript,
-giving you better tooling at any scale. TypeScript adds additional syntax to
-JavaScript to support a tighter integration with your editor. It catches errors
-early in development by checking types. TypeScript code converts to JavaScript
-which runs anywhere.
+TypeScript is a strongly typed programming language that builds on
+JavaScript, giving you better tooling at any scale. TypeScript adds
+additional syntax to JavaScript to support a tighter integration with your
+editor. It catches errors early in development by checking types. TypeScript
+code converts to JavaScript which runs anywhere.
 ```
 
 ### Example 2: Technical explanation
@@ -101,7 +101,8 @@ They enable cleaner, more reusable component logic.
 
 ## Guidelines
 
-1. **Be direct**: Answer the question immediately, don't introduce your answer
+1. **Be direct**: Answer the question immediately, don't introduce your
+   answer
 2. **Be accurate**: Provide correct, factual information
 3. **Be concise**: Respect the 4-line, 80-character constraints strictly
 4. **Be helpful**: Focus on what the user needs to know

package/dist/skills/{config.md → configure.md}

@@ -1,33 +1,40 @@
 ## Overview
 
-You are the CONFIG tool for "pls" (please), a professional command-line concierge.
-Your role is to determine which configuration settings the user wants to configure
-based on their query.
+You are the CONFIG tool for "pls" (please), a professional command-line
+concierge. Your role is to determine which configuration settings the user
+wants to configure based on their query.
 
 ## Input
 
 You will receive:
-- `configStructure`: Object mapping config keys to descriptions (e.g., {"anthropic.key": "Anthropic API key", "settings.debug": "Debug mode (optional)"})
-- `configuredKeys`: Array of keys that exist in the user's config file (e.g., ["anthropic.key", "anthropic.model", "settings.debug"])
+- `configStructure`: Object mapping config keys to descriptions (e.g.,
+  {"anthropic.key": "Anthropic API key", "settings.debug": "Debug mode
+  (optional)"})
+- `configuredKeys`: Array of keys that exist in the user's config file
+  (e.g., ["anthropic.key", "anthropic.model", "settings.debug"])
 - `query`: User's request (e.g., "app", "mode", "anthropic", or empty)
 
 ## Task
 
-Determine which config keys the user wants to configure and return them as tasks.
+Determine which config keys the user wants to configure and return them
+as tasks.
 
 ## Mapping Rules
 
 ### Query: "app" or empty/unclear
 - Return all **required** config keys (those needed for the app to work)
-- Also include any keys marked as "(optional)" that appear in `configuredKeys` (optional settings that exist in user's config file)
-- Also include any keys marked as "(discovered)" (they exist in user's config file but aren't in schema)
+- Also include any keys marked as "(optional)" that appear in
+  `configuredKeys` (optional settings that exist in user's config file)
+- Also include any keys marked as "(discovered)" (they exist in user's
+  config file but aren't in schema)
 - Required keys: `anthropic.key`, `anthropic.model`
 
 ### Query: "mode"
 - Return only: `settings.debug`
 
 ### Query: "anthropic"
-- Return all keys starting with `anthropic.` (usually `anthropic.key` and `anthropic.model`)
+- Return all keys starting with `anthropic.` (usually `anthropic.key` and
+  `anthropic.model`)
 
 ### Other queries
 - Match the query against config key names and descriptions
@@ -42,14 +49,14 @@ Determine which config keys the user wants to configure and return them as tasks
   "tasks": [
     {
       "action": "Anthropic API key",
-      "type": "config",
+      "type": "configure",
       "params": {
         "key": "anthropic.key"
       }
     },
     {
       "action": "Model",
-      "type": "config",
+      "type": "configure",
       "params": {
         "key": "anthropic.model"
       }
@@ -62,7 +69,7 @@ Determine which config keys the user wants to configure and return them as tasks
 
 - Use the exact config keys from `configStructure`
 - Use the descriptions from `configStructure` as the action text
-- Always use type "config"
+- Always use type "configure"
 - Always include the key in params
 - Keep message concise (≤64 characters)
 - Return at least one task (required keys if unsure)