@devkitvault/recall 1.2.3 → 1.2.5

package/README.md

@@ -39,7 +39,7 @@ recall playbook run deploy --dry-run
 
 `recall playbook run` executes steps. Ask never does.
 
-Ask prints a suggestion (`source` is `vault`, `cache`, or `llm`). Copy or save it yourself.
+Ask prints a suggestion (`source` is `vault`, `cache`, or `recall agent` for a generated answer). Copy or save it yourself.
 
 ```sh
 recall save "docker compose up -d" --name docker --tags docker

package/dist/commands/ask.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.askCommand = void 0;
 exports.printSuggestion = printSuggestion;
 exports.printAskError = printAskError;
+exports.promptSaveMeta = promptSaveMeta;
 exports.saveSuggestion = saveSuggestion;
 exports.resolveAsk = resolveAsk;
 exports.runAsk = runAsk;
@@ -17,7 +18,9 @@ const auth_1 = require("../lib/auth");
 const events_1 = require("../lib/events");
 const project_1 = require("../lib/project");
 const runtime_1 = require("../lib/runtime");
+const source_label_1 = require("../lib/source-label");
 const spinner_1 = require("../lib/spinner");
+const tags_1 = require("../lib/tags");
 function riskColor(risk) {
     if (risk === 'DANGEROUS')
         return chalk_1.default.red(risk);
@@ -34,7 +37,7 @@ function printSuggestion(result) {
         console.log(`  ${chalk_1.default.dim(result.explanation)}`);
     }
     console.log();
-    console.log(`  ${chalk_1.default.dim('shell:')} ${result.shell}    ${chalk_1.default.dim('risk:')} ${riskColor(result.risk)}    ${chalk_1.default.dim('source:')} ${result.source}`);
+    console.log(`  ${chalk_1.default.dim('shell:')} ${result.shell}    ${chalk_1.default.dim('risk:')} ${riskColor(result.risk)}    ${chalk_1.default.dim('source:')} ${(0, source_label_1.sourceLabel)(result.source)}`);
     if (result.source === 'vault') {
         const playbook = result.explanation?.includes('playbooks');
         console.log(chalk_1.default.dim(playbook ? '  from your playbooks' : '  from your vault'));
@@ -67,12 +70,25 @@ function printAskError(err) {
     }
     console.error(chalk_1.default.red('\n  Failed to resolve that request.\n'));
 }
-function parseTags(raw) {
-    const tags = (raw ?? '')
-        .split(',')
-        .map((t) => t.trim())
-        .filter(Boolean);
-    return tags.length ? tags : undefined;
+async function promptSaveMeta(existingName) {
+    const questions = [];
+    if (!existingName?.trim()) {
+        questions.push({
+            type: 'input',
+            name: 'name',
+            message: 'Name (optional):',
+        });
+    }
+    questions.push({
+        type: 'input',
+        name: 'tags',
+        message: 'Tags (optional):',
+    });
+    const answers = await inquirer_1.default.prompt(questions);
+    return {
+        name: existingName?.trim() || answers.name,
+        tags: (0, tags_1.parseTags)(answers.tags),
+    };
 }
 async function saveSuggestion(token, command, name, source, risk, tags) {
     await api_1.ApiClient.post('/commands', {
@@ -81,7 +97,7 @@ async function saveSuggestion(token, command, name, source, risk, tags) {
         tags,
     }, token);
     await (0, events_1.track)('ai_accepted', { source, risk, saved: true });
-    console.log(chalk_1.default.green('\n  Saved.\n'));
+    console.log(chalk_1.default.green(`\n  ${(0, tags_1.formatSavedMessage)(name, tags)}\n`));
 }
 async function resolveAsk(opts) {
     const runtime = (0, runtime_1.detectRuntime)();
@@ -124,27 +140,16 @@ async function runAsk(query) {
         }]);
     if (!save)
         return;
-    const { name, tags } = await inquirer_1.default.prompt([
-        {
-            type: 'input',
-            name: 'name',
-            message: 'Name (optional):',
-        },
-        {
-            type: 'input',
-            name: 'tags',
-            message: 'Tags (optional):',
-        },
-    ]);
+    const { name, tags } = await promptSaveMeta();
     try {
-        await saveSuggestion(token, result.command, name, result.source, result.risk, parseTags(tags));
+        await saveSuggestion(token, result.command, name, result.source, result.risk, tags);
     }
     catch (err) {
         printAskError(err);
     }
 }
 exports.askCommand = new commander_1.Command('ask')
-    .description('Suggest a command from natural language (does not run it)')
+    .description('Suggest a terminal command. Ask is for terminal commands only and does not run them.')
     .argument('<query...>', 'What you want to do')
     .action(async (parts) => {
     await runAsk(parts.join(' '));

package/dist/commands/repl.js

@@ -11,8 +11,8 @@ const events_1 = require("../lib/events");
 const turns_1 = require("../lib/turns");
 const ask_1 = require("./ask");
 function printReplHelp() {
-    console.log(chalk_1.default.dim('  Ask prints a command. It does not run it.'));
-    console.log(chalk_1.default.dim('  /save [name]  save the last suggestion'));
+    console.log(chalk_1.default.dim('  Ask is for terminal commands only. It prints a command and does not run it.'));
+    console.log(chalk_1.default.dim('  /save [name]  save the last suggestion (asks for tags)'));
     console.log(chalk_1.default.dim('  /clear        forget this session'));
     console.log(chalk_1.default.dim('  /exit         leave'));
 }
@@ -29,7 +29,7 @@ async function runRepl() {
     let turnIndex = 0;
     let busy = false;
     let open = true;
-    console.log(chalk_1.default.dim('  Ask session. Prints only. /help for commands.'));
+    console.log(chalk_1.default.dim('  Ask is for terminal commands only. Prints only. /help for commands.'));
     rl.prompt();
     async function handleLine(raw) {
         const line = raw.trim();
@@ -54,9 +54,10 @@ async function runRepl() {
                 console.log(chalk_1.default.dim('  nothing to save'));
                 return;
             }
-            const name = line === '/save' ? undefined : line.slice(6).trim();
+            const named = line === '/save' ? undefined : line.slice(6).trim();
             try {
-                await (0, ask_1.saveSuggestion)(token, last.command, name, last.source, last.risk);
+                const { name, tags } = await (0, ask_1.promptSaveMeta)(named);
+                await (0, ask_1.saveSuggestion)(token, last.command, name, last.source, last.risk, tags);
             }
             catch {
                 console.error(chalk_1.default.red('\n  Failed to save.\n'));

package/dist/lib/source-label.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sourceLabel = sourceLabel;
+/** Printed Ask source. API/DB still use `llm` for generated answers. */
+function sourceLabel(source) {
+    return source === 'llm' ? 'recall agent' : source;
+}

package/dist/lib/tags.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseTags = parseTags;
+exports.formatSavedMessage = formatSavedMessage;
+function parseTags(raw) {
+    const tags = (raw ?? '')
+        .split(',')
+        .map((t) => t.trim())
+        .filter(Boolean);
+    return tags.length ? tags : undefined;
+}
+function formatSavedMessage(name, tags) {
+    const label = name?.trim() || undefined;
+    const tagPart = tags?.length ? ` [${tags.join(', ')}]` : '';
+    if (label)
+        return `Saved as "${label}"${tagPart}.`;
+    if (tagPart)
+        return `Saved${tagPart}.`;
+    return 'Saved.';
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devkitvault/recall",
-  "version": "1.2.3",
+  "version": "1.2.5",
   "description": "recall CLI — AI terminal copilot with a personal command vault",
   "keywords": [
     "cli",