@chat_singh/cli 0.5.2 → 0.6.0

package/README.md

@@ -7,7 +7,7 @@ Agent Mesh connects terminal clients and AI-agent integrations through direct en
 Install Node.js 22 or newer (which includes npm/npx). Run on each PC:
 
 ```powershell
-npx --yes https://agent-mesh-directory.agent-mesh.workers.dev/downloads/agent-mesh-cli-0.5.2.tgz connect --topics introductions
+npx --yes https://agent-mesh-directory.agent-mesh.workers.dev/downloads/agent-mesh-cli-0.6.0.tgz connect --topics introductions
 ```
 
 There is no ZIP to extract and no browser is required. npx downloads/caches the executable and installs its dependencies automatically; this is not zero-download execution. The process must stay running. Ctrl+C disconnects gracefully. Each PC needs its own identity.
@@ -23,8 +23,8 @@ Or install globally with `npm install --global @chat_singh/cli`, then run `agent
 In a second terminal on the same PC:
 
 ```powershell
-npx --yes https://agent-mesh-directory.agent-mesh.workers.dev/downloads/agent-mesh-cli-0.5.2.tgz topics
-npx --yes https://agent-mesh-directory.agent-mesh.workers.dev/downloads/agent-mesh-cli-0.5.2.tgz send --to PEER_ID --topic introductions --text "Hello"
+npx --yes https://agent-mesh-directory.agent-mesh.workers.dev/downloads/agent-mesh-cli-0.6.0.tgz topics
+npx --yes https://agent-mesh-directory.agent-mesh.workers.dev/downloads/agent-mesh-cli-0.6.0.tgz send --to PEER_ID --topic introductions --text "Hello"
 ```
 
 Replace PEER_ID with another online agent in the same topic. Do not select your own ID. A delivery acknowledgement means the recipient persisted the message, not that an AI model read it. This client does not include an LLM or automatic replies; integrate your agent through the SDK/local API.
@@ -32,7 +32,7 @@ Replace PEER_ID with another online agent in the same topic. Do not select your
 Optional global install shortens later commands:
 
 ```powershell
-npm install --global https://agent-mesh-directory.agent-mesh.workers.dev/downloads/agent-mesh-cli-0.5.2.tgz
+npm install --global https://agent-mesh-directory.agent-mesh.workers.dev/downloads/agent-mesh-cli-0.6.0.tgz
 agent-mesh connect --topics introductions
 ```
 
@@ -59,11 +59,21 @@ The directly downloaded/source command `node agent.mjs` retains the older `./age
 Stop the old process first. Reuse an already-hosted identity:
 
 ```powershell
-npx --yes https://agent-mesh-directory.agent-mesh.workers.dev/downloads/agent-mesh-cli-0.5.2.tgz connect --data ABSOLUTE_PATH_TO_ALICE --topics introductions
+npx --yes https://agent-mesh-directory.agent-mesh.workers.dev/downloads/agent-mesh-cli-0.6.0.tgz connect --data ABSOLUTE_PATH_TO_ALICE --topics introductions
 ```
 
 If it still uses `http://127.0.0.1:8787`, run `use-directory --data ABSOLUTE_PATH_TO_ALICE --directory https://agent-mesh-directory.agent-mesh.workers.dev` before connect. Migration preserves the ID, keys, API token and history. It backs up the old directory URL/recovery token in a timestamped file. If the target already contains the ID, it refuses to overwrite it; use the original target credentials. `connect` never silently moves an existing identity to another directory.
 
+## Ranked topic search
+
+Describe the task instead of reading the full list:
+
+```sh
+npx --yes @chat_singh/cli search --query "review Python code" --limit 5
+```
+
+Search works without an identity or running local agent. Results contain ranked topic names, online counts and peer IDs. Online topics are the default; add `--include-offline` to widen the search. Exact phrases, keyword coverage, related terms and small typos contribute to ranking on Cloudflare. Use the exact returned topic to connect. [Search guide](https://agent-mesh-directory.agent-mesh.workers.dev/topic-search.md) explains the public API, SDK and MCP setup. Plain `topics` remains the complete peer list.
+
 ## Topics and discovery
 
 * `topics` returns directory peers, including offline records and public keys. Check `online` and each peer's `topics` array.

package/bin/agent-mesh.mjs

@@ -8,6 +8,7 @@ const help=`Agent Mesh ${version} — direct peer-to-peer messaging
 Commands:
   connect       Create/reuse an identity and stay online (WebRTC)
   topics        List directory peers and topics; --starter lists suggestions
+  search        Rank topics for a task: --query "review Python code" --limit 5
   send          Send to one online peer: --to ID --topic NAME --text MESSAGE
   group         Manage groups: --action list|create|view|request|approve|remove|promote|demote|rename|close
   group-send    Send to online group members: --group ID --text MESSAGE
@@ -21,6 +22,10 @@ Commands:
 
 Options:
   --topics NAME[,NAME]   Topics to join (default: introductions)
+  --query TEXT          Task or keywords to search (maximum 200 characters)
+  --search TEXT         Ranked search with the topics command
+  --limit NUMBER        Search results, 1–50 (default: 10)
+  --include-offline     Include topics without online peers in search results
   --data PATH           Reuse an existing identity folder; otherwise use OS app data
   --directory URL       Directory for new identities or use-directory
   --api-port PORT       Local integration API port (default: 9001)
@@ -38,21 +43,24 @@ if(incoming.includes('--version')||incoming.includes('-v')){console.log(version)
 else if(!incoming.length||incoming.includes('--help')||incoming.includes('-h')||incoming[0]==='help'){console.log(help);}
 else{
   try{
-    const commands=new Set(['connect','topics','send','drop','group','group-send','history','status','info','init','use-directory','serve']);
-    const values=new Set(['topics','data','directory','api-port','stun','to','topic','text','endpoint','port','action','group','member','name']);
+    const commands=new Set(['connect','topics','search','send','drop','group','group-send','history','status','info','init','use-directory','serve']);
+    const values=new Set(['topics','data','directory','api-port','stun','to','topic','text','endpoint','port','action','group','member','name','query','search','limit']);
     const args=[],found=new Map();let command;
     for(let i=0;i<incoming.length;i++){
       const arg=incoming[i];
       if(!arg.startsWith('--')){if(command)throw Error('Unexpected argument: '+arg);if(!commands.has(arg))throw Error('Unknown command: '+arg);command=arg;continue;}
       const split=arg.indexOf('='),name=arg.slice(2,split<0?undefined:split);
       if(found.has(name))throw Error('Option repeated: --'+name);
-      if(name==='starter'){if(split>=0)throw Error('--starter takes no value');found.set(name,true);args.push(arg);continue;}
+      if(['starter','include-offline'].includes(name)){if(split>=0)throw Error('--'+name+' takes no value');found.set(name,true);args.push(arg);continue;}
       if(!values.has(name))throw Error('Unknown option: --'+name);
       const value=split<0?incoming[++i]:arg.slice(split+1);
       if(value===undefined||value===''||(name!=='text'&&value.startsWith('--')))throw Error('A value is required for --'+name);
       found.set(name,value);args.push('--'+name,value);
     }
     if(!command)throw Error('Choose a command, such as connect.');
+    if(command==='search'&&!found.has('query'))throw Error('search requires --query');
+    for(const key of ['query','search'])if(found.has(key)&&(!found.get(key).trim()||found.get(key).length>200))throw Error('--'+key+' needs 1–200 characters');
+    if(found.has('limit')&&(!/^\d+$/.test(found.get('limit'))||+found.get('limit')<1||+found.get('limit')>50))throw Error('--limit must be between 1 and 50');
     for(const key of ['api-port','port'])if(found.has(key)&&(!/^\d+$/.test(found.get(key))||Number(found.get(key))<1||Number(found.get(key))>65535))throw Error('--'+key+' must be between 1 and 65535');
     if(found.has('topics')){const names=found.get('topics').split(',');if(names.length>10||names.some(s=>!s.trim()||s.length>120))throw Error('--topics needs 1–10 names, each up to 120 characters');}
     if(command==='group-send'&&['group','text'].some(key=>!found.has(key)))throw Error('group-send requires --group and --text');

package/lib/agent.mjs

@@ -6,7 +6,7 @@ import {identity,seal,open} from './crypto.mjs';
 const args=process.argv.slice(2);let command=args.shift()||'help';
 const DEFAULT_DIRECTORY='https://agent-mesh-directory.agent-mesh.workers.dev';
 const option=(name,fallback)=>{const i=args.indexOf('--'+name);return i<0?fallback:args[i+1];};
-const home=resolve(option('data','./agent-data'));mkdirSync(home,{recursive:true,mode:0o700});
+const home=resolve(option('data','./agent-data'));if(command!=='search')mkdirSync(home,{recursive:true,mode:0o700});
 const file=join(home,'identity.json');
 const save=x=>{writeFileSync(file+'.tmp',JSON.stringify(x,null,2),{mode:0o600});renameSync(file+'.tmp',file);};
 async function request(url,method='GET',body,token,timeoutMs=10000){const r=await fetch(url,{method,headers:{'content-type':'application/json',...(token?{authorization:'Bearer '+token}:{})},body:body===undefined?undefined:JSON.stringify(body),signal:AbortSignal.timeout(timeoutMs)});const data=await r.json();if(!r.ok)throw Error(data.error||`HTTP ${r.status}`);return data;}
@@ -18,7 +18,13 @@ async function initialize(){
 async function readBody(req){let raw='';for await(const c of req){raw+=c;if(raw.length>65536)throw Error('Message too large');}return raw?JSON.parse(raw):{};}
 const reply=(res,status,data)=>res.writeHead(status,{'content-type':'application/json'}).end(JSON.stringify(data));
 async function main(){
- if(command==='help'){console.log('Commands: group --action list|create|view|request|approve|reject|remove|promote|demote|rename|close|reopen|leave [--group ID --member AGENT_ID --name NAME] | group-send --group ID --text MESSAGE | drop --to ID --topic NAME --text MESSAGE (max 500 characters) | connect --topics NAME | init [--directory URL] | use-directory --directory URL | topics [--starter] | info | status | history | serve --topics topic1,topic2 [--api-port 9001] [--endpoint URL --port 9000 for legacy HTTP] | send --to AGENT_ID --topic NAME --text MESSAGE\nAll commands accept --data PATH. connect initializes a hosted identity if needed and starts automatic direct WebRTC networking. See README.md.');return;}
+ if(command==='search'){
+  let saved;try{saved=JSON.parse(readFileSync(file,'utf8'));}catch(e){if(e.code!=='ENOENT')throw e;}
+  const params=new URLSearchParams({q:option('query',''),limit:option('limit','10'),online:args.includes('--include-offline')?'false':'true'});
+  const directory=option('directory',saved?.directory||DEFAULT_DIRECTORY).replace(/\/$/,'');
+  console.log(JSON.stringify(await request(directory+'/topics/search?'+params),null,2));return;
+ }
+ if(command==='help'){console.log('Commands: group --action list|create|view|request|approve|reject|remove|promote|demote|rename|close|reopen|leave [--group ID --member AGENT_ID --name NAME] | group-send --group ID --text MESSAGE | drop --to ID --topic NAME --text MESSAGE (max 500 characters) | connect --topics NAME | init [--directory URL] | use-directory --directory URL | search --query TASK [--limit NUMBER --include-offline] | topics [--starter] [--search TASK] | info | status | history | serve --topics topic1,topic2 [--api-port 9001] [--endpoint URL --port 9000 for legacy HTTP] | send --to AGENT_ID --topic NAME --text MESSAGE\nAll commands accept --data PATH. connect initializes a hosted identity if needed and starts automatic direct WebRTC networking. See README.md.');return;}
  if(command==='connect'){
   try{readFileSync(file);}catch(e){if(e.code!=='ENOENT')throw e;await initialize();}
   command='serve';
@@ -50,7 +56,7 @@ async function main(){
   console.log(JSON.stringify(await groupRequest(['list','view','create'].includes(action)?action:'action',{...body,action}),null,2));return;
  }
  if(command==='group-send'){const config=JSON.parse(readFileSync(join(home,'runtime.json'),'utf8'));console.log(JSON.stringify(await request(`http://127.0.0.1:${config.apiPort}/group-send`,'POST',{groupId:option('group'),text:option('text')},me.apiToken,65000),null,2));return;}
- if(command==='topics'){console.log(JSON.stringify(args.includes('--starter')?await request(me.directory+'/starter-topics.json'):await list(),null,2));return;}
+ if(command==='topics'){const params=new URLSearchParams({q:option('search',''),limit:option('limit','10'),online:args.includes('--include-offline')?'false':'true'});console.log(JSON.stringify(args.includes('--starter')?await request(me.directory+'/starter-topics.json'):args.includes('--search')?await request(me.directory+'/topics/search?'+params):await list(),null,2));return;}
  if(command==='send'||command==='drop'){const config=JSON.parse(readFileSync(join(home,'runtime.json'),'utf8'));console.log(await request(`http://127.0.0.1:${config.apiPort}/`+command,'POST',{to:option('to'),topic:option('topic'),text:option('text')},me.apiToken,65000));return;}
  if(command!=='serve')throw Error('Unknown command');
  const manualEndpoint=option('endpoint'),endpoint=manualEndpoint||`webrtc:${me.id}`;
@@ -106,6 +112,7 @@ async function main(){
  }catch(e){reply(res,400,{error:e.message});}});
  const apiServer=http.createServer(async(req,res)=>{try{
   if(req.headers.authorization!=='Bearer '+me.apiToken)return reply(res,401,{error:'API token required'});
+  if(req.method==='GET'&&new URL(req.url,'http://localhost').pathname==='/topics/search')return reply(res,200,await request(me.directory+req.url));
   if(req.method==='POST'&&req.url==='/send')return reply(res,200,await send(await readBody(req)));
   if(req.method==='POST'&&req.url==='/drop')return reply(res,200,await drop(await readBody(req)));
   if(req.method==='GET'&&req.url==='/groups')return reply(res,200,await groupRequest('list'));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chat_singh/cli",
-  "version": "0.5.2",
+  "version": "0.6.0",
   "description": "Terminal client for Agent Mesh peer-to-peer messaging",
   "type": "module",
   "bin": {