cueme 0.1.6 → 0.1.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cueme",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Cue command protocol adapter (stdin/stdout JSON)",
   "license": "Apache-2.0",
   "files": [
@@ -16,12 +16,12 @@
   },
   "type": "commonjs",
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
   "scripts": {
     "prepare": "node -c src/cli.js && node -c src/handler.js"
   },
   "dependencies": {
-    "better-sqlite3": "^11.7.0"
+    "better-sqlite3": "^12.6.0"
   }
 }

package/protocol.md

@@ -2,24 +2,26 @@
 
 你与用户的协作交互通过命令行工具 `cueme` 完成。
 
+- 首次连接 / 无 agent_id：先执行 `join()` 获取 agent_id，再执行 `cue()`。
+
+- 重连 / 已有 agent_id（例如网络波动导致 cue 中断但对话仍在继续）：用户再次发送 `cue` 时，优先直接用已有 agent_id 执行 `cue()`；仅当无法确认 agent_id 时才重新 `join()`。
+
 当用户接受 HAP：你必须在每次阶段性输出或准备结束回复前调用 `cueme cue`（或 `cueme pause`）等待用户继续。
 
 If HAP is accepted: before any phase-summary or final reply, you MUST call `cueme cue` via the terminal/tool.
 A reply is NOT complete unless the last action is a successful cueme call.
 
-- 首次连接 / 无 agent_id：先执行 `join()` 获取 agent_id，再执行 `cue()`。
-
-- 重连 / 已有 agent_id（例如网络波动导致 cue 中断但对话仍在继续）：用户再次发送 `cue` 时，优先直接用已有 agent_id 执行 `cue()`；仅当无法确认 agent_id 时才重新 `join()`。
-
 ## No fake tool actions
 
 You MUST NOT claim you called cueme unless you actually executed it and got its stdout.
 If you cannot run tools, say "TOOLS_UNAVAILABLE" and output only the exact `cueme ...` command for the human to run.
 
-**IMPORTANT: cueme 命令不可放在后台运行。** All cueme commands must run in blocking/foreground mode to ensure proper interaction flow.
+
 
 ## cueme (command interface)
 
+cueme 命令不可放在后台运行.All cueme commands must run in blocking/foreground mode to ensure proper interaction flow.
+
 ### join() -> message
 
 Command:
@@ -36,30 +38,20 @@ Returns (plain text):
 - Format: lowercase, `_` only.
 - Examples: `windsurf`, `cursor`, `vscode`, `claude_code`, `terminal`, `codex`, `kiro`, `opencode`.
 
-### recall(hints: str) -> message
+### cue(agent_id: str, stdin: {prompt: str!, payload?: object | null}) -> text
 
-Command:
-
-- `cueme recall <hints>`
-
-Returns (plain text):
-
-- a short message (includes `agent_id=...`)
-
-### cue(prompt: str, agent_id: str, payload?: object | null) -> text
-
-Command:
+Command (requires stdin):
 
 `cueme cue <agent_id> -`
 
-stdin envelope (tag blocks; tags must be alone on their line):
+Provide via stdin (tag-block envelope, MUST NOT be empty; bash/zsh use heredoc; PowerShell use here-string):
 
 <cueme_prompt>
-...raw prompt text...
+Your actual prompt text here
 </cueme_prompt>
 
 <cueme_payload>
-...JSON object or null...
+{"type":"confirm","text":"Continue?"}
 </cueme_payload>
 
 Rules:
@@ -82,12 +74,6 @@ Payload protocol (payload object):
 - confirm: {"type":"confirm","text":"...","confirm_label":"Confirm","cancel_label":"Cancel"}
 - form: {"type":"form","fields":[{"label":"...","kind":"text","options":["...",...],"allow_multiple":false}, ...]}
 
-Minimal examples:
-
-- choice: {"type":"choice","options":["Continue","Stop"]}
-- confirm: {"type":"confirm","text":"Continue?"}
-- form: {"type":"form","fields":[{"label":"Env","options":["prod","staging"]}]}
-
 ### pause(agent_id: str, prompt?: str) -> text
 
 Command:

package/src/cli.js

@@ -103,7 +103,6 @@ async function main() {
         '  cueme proto ls',
         '  cueme proto path <agent>',
         '  cueme join <agent_runtime>',
-        '  cueme recall <hints>',
         '  cueme cue <agent_id> -',
         '  cueme pause <agent_id> [prompt|-]',
         '',
@@ -121,7 +120,7 @@ async function main() {
         '  </cueme_prompt>',
         '',
         'Output:',
-        '  - join/recall/cue/pause: plain text (stdout)',
+        '  - join/cue/pause: plain text (stdout)',
       ].join('\n') + '\n'
     );
     return;
@@ -133,8 +132,8 @@ async function main() {
     return;
   }
 
-  if (parsed.agent_id != null || parsed.prompt != null || parsed.hints != null) {
-    process.stderr.write('error: --agent_id/--prompt/--hints flags are not supported; use positional args\n');
+  if (parsed.agent_id != null || parsed.prompt != null) {
+    process.stderr.write('error: --agent_id/--prompt flags are not supported; use positional args\n');
     process.exitCode = 2;
     return;
   }
@@ -149,16 +148,6 @@ async function main() {
     parsed.agent_runtime = String(agentRuntime);
   }
 
-  if (sub === 'recall') {
-    const hints = pos[0];
-    if (!hints) {
-      process.stderr.write('error: missing <hints>\n');
-      process.exitCode = 2;
-      return;
-    }
-    parsed.hints = String(hints);
-  }
-
   if (sub === 'proto') {
     const action = pos[0];
     try {

package/src/envelope.js

@@ -3,7 +3,10 @@ function parseTagBlocksEnvelope(raw, opts = {}) {
   const text = String(raw == null ? '' : raw);
   const trimmed = text.trim();
   if (!trimmed) {
-    return { ok: false, error: 'error: stdin must use tag-blocks envelope\n' };
+    // Fallback: use default prompt based on command type
+    // allowPayload === true means cue command, false means pause command
+    const defaultPrompt = allowPayload ? 'hi' : 'pause';
+    return { ok: true, prompt: defaultPrompt, payload: null };
   }
 
   if (trimmed.startsWith('{')) {

package/src/handler.js

@@ -148,39 +148,11 @@ async function handleJoin(db, agent_runtime) {
         `project_dir=${project_dir}\n` +
         `agent_terminal=${agent_terminal}\n` +
         `agent_runtime=${normalized_runtime}\n\n` +
-        'Use this agent_id when calling cue(prompt, agent_id).' +
-        ' You must remember this agent_id: when calling cue(), pass it as agent_id so the system knows who you are.' +
-        ' Before ending this session, call cue. Please use cue to provide a final summary, ask a question, or make a request.',
-    },
-  };
-}
-
-async function handleRecall(db, hints) {
-  const row = await get(
-    db,
-    "SELECT agent_id FROM cue_requests WHERE agent_id != '' AND prompt LIKE ? ORDER BY created_at DESC LIMIT 1",
-    [`%${hints}%`]
-  );
-
-  if (row && row.agent_id) {
-    return {
-      ok: true,
-      data: {
-        agent_id: row.agent_id,
-        message: `agent_id=${row.agent_id}\n\nUse this agent_id when calling cue(prompt, agent_id).`,
-      },
-    };
-  }
-
-  const agent_id = generateName();
-  return {
-    ok: true,
-    data: {
-      agent_id,
-      message:
-        'No matching record found; generated a new agent_id.\n\n' +
-        `agent_id=${agent_id}\n\n` +
-        'Use this agent_id when calling cue(prompt, agent_id).',
+        'Use this agent_id when calling: cueme cue <agent_id> -\n' +
+        'Then provide stdin with tag-block envelope (stdin MUST NOT be empty):\n' +
+        '<cueme_prompt>\n...\n</cueme_prompt>\n' +
+        '<cueme_payload>\n...\n</cueme_payload>\n\n' +
+        'Remember this agent_id (but do NOT store it in any memory module). Before ending this session, call cue to provide a final summary, ask a question, or make a request.',
     },
   };
 }
@@ -358,11 +330,6 @@ async function handleCommand({ subcommand, args }) {
 
     if (subcommand === 'join') return await handleJoin(db, args.agent_runtime);
 
-    if (subcommand === 'recall') {
-      const hints = (args.hints ?? '').toString();
-      return await handleRecall(db, hints);
-    }
-
     if (subcommand === 'cue') {
       const agent_id = (args.agent_id ?? '').toString();
       const prompt = (args.prompt ?? '').toString();

package/src/proto.js

@@ -51,22 +51,22 @@ function detectVscodeCandidates({ platform }) {
   const cwd = process.cwd();
 
   // Workspace-level (if you want repo-local rules)
-  candidates.push(path.join(cwd, '.vscode', 'prompts', 'human_proto.md'));
+  candidates.push(path.join(cwd, '.vscode', 'prompts', 'cueme_proto.instructions.md'));
 
   // User-level prompts
   const home = os.homedir();
   if (platform === 'macos') {
     candidates.push(
-      path.join(home, 'Library', 'Application Support', 'Code', 'User', 'prompts', 'human_proto.md')
+      path.join(home, 'Library', 'Application Support', 'Code', 'User', 'prompts', 'cueme_proto.instructions.md')
     );
   }
   if (platform === 'linux') {
     // User supplied: ~/.config/Code/User/prompts/
-    candidates.push(path.join(home, '.config', 'Code', 'User', 'prompts', 'human_proto.md'));
+    candidates.push(path.join(home, '.config', 'Code', 'User', 'prompts', 'cueme_proto.instructions.md'));
   }
   if (platform === 'windows') {
     const appData = process.env.APPDATA;
-    if (appData) candidates.push(path.join(appData, 'Code', 'User', 'prompts', 'human_proto.md'));
+    if (appData) candidates.push(path.join(appData, 'Code', 'User', 'prompts', 'cueme_proto.instructions.md'));
   }
 
   return candidates;
@@ -113,12 +113,12 @@ function defaultPathMapTemplate() {
     'Code',
     'User',
     'prompts',
-    'human_proto.md'
+    'cueme_proto.instructions.md'
   );
   out['windows.vscode'] = appData
-    ? path.join(appData, 'Code', 'User', 'prompts', 'human_proto.md')
-    : path.join(userProfile, 'AppData', 'Roaming', 'Code', 'User', 'prompts', 'human_proto.md');
-  out['linux.vscode'] = path.join(home, '.config', 'Code', 'User', 'prompts', 'human_proto.md');
+    ? path.join(appData, 'Code', 'User', 'prompts', 'cueme_proto.instructions.md')
+    : path.join(userProfile, 'AppData', 'Roaming', 'Code', 'User', 'prompts', 'cueme_proto.instructions.md');
+  out['linux.vscode'] = path.join(home, '.config', 'Code', 'User', 'prompts', 'cueme_proto.instructions.md');
 
   // Windsurf
   out['macos.windsurf'] = path.join(home, '.codeium', 'windsurf', 'memories', 'global_rules.md');
@@ -256,7 +256,7 @@ function buildFinalProto({ cfg, agent }) {
     throw new Error('error: cannot read protocol.md');
   }
 
-  return `${prefix}\n\n${protocol}`;
+  return { prefix, protocol };
 }
 
 function resolveTargetPath({ cfg, agent }) {
@@ -271,15 +271,22 @@ function resolveTargetPath({ cfg, agent }) {
   return path.isAbsolute(expanded) ? expanded : path.resolve(process.cwd(), expanded);
 }
 
-function makeManagedBlock({ finalProto, eol }) {
-  const normalized = String(finalProto || '').replace(/\r\n/g, '\n').replace(/\r/g, '\n');
-  const protoLines = normalized.split('\n');
-  return [BEGIN_MARKER, ...protoLines, END_MARKER].join(eol) + eol;
+function makeManagedBlock({ prefix, protocol, eol }) {
+  const normalizedProto = String(protocol || '').replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+  const protoLines = normalizedProto.split('\n');
+  const managedBlock = [BEGIN_MARKER, ...protoLines, END_MARKER].join(eol) + eol;
+  
+  if (prefix && prefix.trim()) {
+    const normalizedPrefix = String(prefix).replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+    return normalizedPrefix + eol + eol + managedBlock;
+  }
+  
+  return managedBlock;
 }
 
-function applyManagedBlock({ existing, finalProto }) {
+function applyManagedBlock({ existing, prefix, protocol }) {
   const eol = detectEol(existing);
-  const block = makeManagedBlock({ finalProto, eol });
+  const block = makeManagedBlock({ prefix, protocol, eol });
 
   const beginMatch = existing.match(BEGIN_MARKER_RE);
   const endMatch = existing.match(END_MARKER_RE);
@@ -333,7 +340,7 @@ function protoLs() {
 function protoApply(agent) {
   const cfg = readConfigOrThrow({ auto_init: true });
   const targetPath = resolveTargetPath({ cfg, agent });
-  const finalProto = buildFinalProto({ cfg, agent });
+  const { prefix, protocol } = buildFinalProto({ cfg, agent });
 
   let existing = '';
   let exists = false;
@@ -346,13 +353,13 @@ function protoApply(agent) {
   }
 
   const eol = exists ? detectEol(existing) : os.EOL;
-  const managedBlock = makeManagedBlock({ finalProto, eol });
+  const managedBlock = makeManagedBlock({ prefix, protocol, eol });
 
   let out;
   if (!exists) {
     out = managedBlock;
   } else {
-    out = applyManagedBlock({ existing, finalProto });
+    out = applyManagedBlock({ existing, prefix, protocol });
   }
 
   ensureDirForFile(targetPath);