cueme 0.1.1 → 0.1.2

package/README.md

@@ -1,13 +1,21 @@
 # cueme
 
-A command protocol adapter for Cue (stdin/stdout JSON), compatible with the existing SQLite mailbox (`~/.cue/cue.db`).
+A command protocol adapter for Cue, compatible with the existing SQLite mailbox (`~/.cue/cue.db`).
 
-## Install
+## Quick start (2 steps)
+
+### Step 1: Install cueme
 
 ```bash
 npm install -g cueme
 ```
 
+### Step 2: Configure the protocol.md as your system prompt
+
+Add the contents of `cue-command/protocol.md` to your tool's system prompt / rules.
+
+This file defines the Human Agent Protocol (HAP) rules and the `cueme` command interface.
+
 ## Usage
 
 ### join
@@ -34,13 +42,7 @@ cueme cue --agent_id "tavilron" --prompt "What should I do next?" --timeout 600
 cueme pause --agent_id "tavilron" --prompt "Waiting..."
 ```
 
-### rpc mode (stdin)
-
-```bash
-echo '{"cmd":"join"}' | cueme rpc
-```
-
-All commands output one JSON object to stdout.
+All commands output plain text to stdout.
 
 ## Release
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cueme",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Cue command protocol adapter (stdin/stdout JSON)",
   "license": "Apache-2.0",
   "files": [
@@ -20,6 +20,6 @@
     "prepare": "node -c src/cli.js && node -c src/handler.js"
   },
   "dependencies": {
-    "sqlite3": "^5.1.7"
+    "better-sqlite3": "^11.7.0"
   }
 }

package/src/cli.js

@@ -1,4 +1,3 @@
-const { readAllStdin } = require('./io');
 const { handleCommand } = require('./handler');
 
 function parseArgs(argv) {
@@ -25,6 +24,26 @@ function parseArgs(argv) {
   return out;
 }
 
+function extractTextFromResult(result) {
+  if (!result || typeof result !== 'object') return '';
+  if (result.ok === false) return result.error ? String(result.error) : '';
+
+  const data = result.data;
+  if (!data || typeof data !== 'object') return '';
+
+  const contents = Array.isArray(data.contents) ? data.contents : [];
+  const textParts = [];
+  for (const c of contents) {
+    if (c && c.type === 'text' && typeof c.text === 'string' && c.text.length > 0) {
+      textParts.push(c.text);
+    }
+  }
+  if (textParts.length > 0) return textParts.join('');
+
+  if (typeof data.message === 'string') return data.message;
+  return '';
+}
+
 async function main() {
   const parsed = parseArgs(process.argv);
   const sub = parsed._[0];
@@ -32,31 +51,23 @@ async function main() {
   if (!sub || sub === 'help' || sub === '-h' || sub === '--help') {
     process.stdout.write(
       [
-        'cueme (stdin/stdout JSON)',
+        'cueme',
         '',
         'Usage:',
         '  cueme join',
         '  cueme recall --hints "..."',
         '  cueme cue --agent_id "..." --prompt "..." [--payload "{...}"] [--timeout 600]',
         '  cueme pause --agent_id "..." [--prompt "..."]',
-        '  cueme rpc   # read one JSON object from stdin: {"cmd":...}',
         '',
-        'All commands output a single JSON object to stdout.',
+        'Output:',
+        '  - join/recall/cue/pause: plain text (stdout)',
       ].join('\n') + '\n'
     );
     return;
   }
 
-  let input = null;
-  if (sub === 'rpc' || parsed.json) {
-    const raw = await readAllStdin();
-    if (raw.trim().length > 0) {
-      input = JSON.parse(raw);
-    }
-  }
-
-  const result = await handleCommand({ subcommand: sub, args: parsed, input });
-  process.stdout.write(JSON.stringify(result) + '\n');
+  const result = await handleCommand({ subcommand: sub, args: parsed });
+  process.stdout.write(extractTextFromResult(result) + '\n');
 }
 
 module.exports = { main };

package/src/db.js

@@ -1,7 +1,7 @@
 const os = require('os');
 const path = require('path');
 const fs = require('fs');
-const sqlite3 = require('sqlite3');
+const Database = require('better-sqlite3');
 
 function getDbPath() {
   return path.join(os.homedir(), '.cue', 'cue.db');
@@ -15,26 +15,18 @@ function ensureDbDir() {
 
 function openDb() {
   const dbPath = ensureDbDir();
-  const db = new sqlite3.Database(dbPath);
+  const db = new Database(dbPath);
   return { db, dbPath };
 }
 
-function run(db, sql, params = []) {
-  return new Promise((resolve, reject) => {
-    db.run(sql, params, function onRun(err) {
-      if (err) return reject(err);
-      resolve({ lastID: this.lastID, changes: this.changes });
-    });
-  });
+async function run(db, sql, params = []) {
+  const info = db.prepare(sql).run(params);
+  return { lastID: info.lastInsertRowid, changes: info.changes };
 }
 
-function get(db, sql, params = []) {
-  return new Promise((resolve, reject) => {
-    db.get(sql, params, (err, row) => {
-      if (err) return reject(err);
-      resolve(row || null);
-    });
-  });
+async function get(db, sql, params = []) {
+  const row = db.prepare(sql).get(params);
+  return row || null;
 }
 
 async function initSchema(db) {
@@ -74,7 +66,22 @@ async function initSchema(db) {
 }
 
 function nowIso() {
-  return new Date().toISOString();
+  const now = new Date();
+  const offset = -now.getTimezoneOffset();
+  const sign = offset >= 0 ? '+' : '-';
+  const pad = (n) => String(Math.abs(n)).padStart(2, '0');
+  const offsetHours = pad(Math.floor(Math.abs(offset) / 60));
+  const offsetMinutes = pad(Math.abs(offset) % 60);
+  
+  const year = now.getFullYear();
+  const month = pad(now.getMonth() + 1);
+  const day = pad(now.getDate());
+  const hours = pad(now.getHours());
+  const minutes = pad(now.getMinutes());
+  const seconds = pad(now.getSeconds());
+  const ms = String(now.getMilliseconds()).padStart(3, '0');
+  
+  return `${year}-${month}-${day}T${hours}:${minutes}:${seconds}.${ms}${sign}${offsetHours}:${offsetMinutes}`;
 }
 
 module.exports = { openDb, initSchema, run, get, nowIso, getDbPath };

package/src/handler.js

@@ -86,7 +86,7 @@ async function handleJoin(db) {
 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',
+    "SELECT agent_id FROM cue_requests WHERE agent_id != '' AND prompt LIKE ? ORDER BY created_at DESC LIMIT 1",
     [`%${hints}%`]
   );
 
@@ -220,15 +220,6 @@ async function handleCueLike(db, { mode, agent_id, prompt, payload, timeoutSecon
       };
     }
 
-    if (mode === 'cue') {
-      const updated_at = nowIso();
-      await run(
-        db,
-        'UPDATE cue_requests SET status = ?, updated_at = ? WHERE request_id = ?',
-        ['COMPLETED', updated_at, request_id]
-      );
-    }
-
     return {
       ok: true,
       data: {
@@ -287,36 +278,11 @@ async function handlePause(db, { agent_id, prompt }) {
   });
 }
 
-async function handleCommand({ subcommand, args, input }) {
+async function handleCommand({ subcommand, args }) {
   const { db, dbPath } = openDb();
   try {
     await initSchema(db);
 
-    if (subcommand === 'rpc') {
-      if (!input || typeof input !== 'object') {
-        return { ok: false, error: 'rpc expects a JSON object on stdin' };
-      }
-      const cmd = input.cmd;
-      if (cmd === 'join') return await handleJoin(db);
-      if (cmd === 'recall') return await handleRecall(db, String(input.hints || ''));
-      if (cmd === 'cue') {
-        return await handleCueLike(db, {
-          mode: 'cue',
-          agent_id: String(input.agent_id || ''),
-          prompt: String(input.prompt || ''),
-          payload: input.payload == null ? null : String(input.payload),
-          timeoutSeconds: input.timeout == null ? 600 : Number(input.timeout),
-        });
-      }
-      if (cmd === 'pause') {
-        return await handlePause(db, {
-          agent_id: String(input.agent_id || ''),
-          prompt: input.prompt == null ? null : String(input.prompt),
-        });
-      }
-      return { ok: false, error: `unknown cmd: ${cmd}` };
-    }
-
     if (subcommand === 'join') return await handleJoin(db);
 
     if (subcommand === 'recall') {