@pingagent/sdk 0.1.1 → 0.1.2

package/bin/pingagent.js

@@ -756,15 +756,118 @@ program
     }
   });
 
-// === Conversations (local history management) ===
-const conversations = program.command('conversations').description('Manage conversation local history');
+// === Conversations (local history management + server view) ===
+const conversations = program.command('conversations').description('Manage conversations (local history and server-side metadata)');
+
+conversations
+  .command('list')
+  .description('List server conversations for the current identity (optionally by profile). Use --type pending_dm to see only pending contact requests.')
+  .option('--profile <name>', 'Use profile from ~/.pingagent/<name>')
+  .option('--type <dm|pending_dm|all>', 'Filter: dm (established only), pending_dm (waiting for approval), or all (default)', 'all')
+  .option('--json', 'Output as JSON')
+  .action(async (opts = {}) => {
+    const identityPath = getIdentityPathForCommand(opts);
+    if (!identityExists(identityPath)) {
+      console.error('No identity found. Run: pingagent init (or use --identity-dir / --profile / PINGAGENT_IDENTITY_PATH)');
+      process.exit(1);
+    }
+    const client = await getClient(identityPath);
+    const typeArg = opts.type === 'pending_dm' ? 'pending_dm' : opts.type === 'dm' ? 'dm' : undefined;
+    const res = await client.listConversations(typeArg ? { type: typeArg } : undefined);
+    const convos = res.ok && res.data?.conversations ? res.data.conversations : [];
+    const raw = program.opts().raw;
+    if (opts.json) {
+      console.log(JSON.stringify({ ok: res.ok, conversations: convos }, null, 2));
+    } else if (!res.ok) {
+      if (res.error) printError(res.error);
+      else console.error('Failed to list conversations');
+      process.exit(1);
+    } else if (convos.length === 0) {
+      const hint = typeArg === 'pending_dm'
+        ? 'No pending contact requests.'
+        : 'No conversations. Send a message (pingagent chat --to <did>) or approve a contact request first.';
+      console.log(hint);
+    } else {
+      for (const c of convos) {
+        const ts = c.last_message_ts_ms != null ? formatTs(c.last_message_ts_ms, raw) : '-';
+        const target = c.target_did?.slice(0, 30) ?? '?';
+        console.log(`  ${c.conversation_id}  ${c.trusted ? 'ready' : 'pending'}  last: ${ts}  target: ${target}`);
+      }
+      console.log(`\n${convos.length} conversation(s)`);
+    }
+  });
+
+conversations
+  .command('show')
+  .description('Show details and recent messages for a conversation')
+  .option('--profile <name>', 'Use profile from ~/.pingagent/<name>')
+  .argument('<conversation_id>', 'Conversation ID')
+  .option('--limit <n>', 'Number of recent messages to fetch', '20')
+  .option('--json', 'Output as JSON')
+  .action(async (conversationId, opts = {}) => {
+    const identityPath = getIdentityPathForCommand(opts);
+    if (!identityExists(identityPath)) {
+      console.error('No identity found. Run: pingagent init (or use --identity-dir / --profile / PINGAGENT_IDENTITY_PATH)');
+      process.exit(1);
+    }
+    const client = await getClient(identityPath);
+    const metaRes = await client.listConversations({ type: 'dm' });
+    const convo = metaRes.ok && metaRes.data?.conversations
+      ? metaRes.data.conversations.find(c => c.conversation_id === conversationId)
+      : null;
+    const limit = parseInt(opts.limit, 10) || 20;
+    const inboxRes = await client.fetchInbox(conversationId, { sinceSeq: 0, limit, box: 'all' });
+    const messages = inboxRes.ok && inboxRes.data?.messages ? inboxRes.data.messages : [];
+    const raw = program.opts().raw;
+
+    if (opts.json) {
+      console.log(JSON.stringify({
+        ok: metaRes.ok && inboxRes.ok,
+        conversation: convo ?? null,
+        messages,
+      }, null, 2));
+      return;
+    }
+
+    if (!inboxRes.ok) {
+      if (inboxRes.error) printError(inboxRes.error);
+      else console.error('Failed to fetch messages for conversation');
+      process.exit(1);
+    }
+
+    if (convo) {
+      console.log(`Conversation: ${convo.conversation_id}`);
+      console.log(`Type: ${convo.type}`);
+      console.log(`Trusted: ${convo.trusted}`);
+      console.log(`Target DID: ${convo.target_did ?? '-'}`);
+      if (convo.last_message_ts_ms != null) {
+        console.log(`Last message: ${formatTs(convo.last_message_ts_ms, raw)}`);
+      }
+      console.log('');
+    }
+
+    if (messages.length === 0) {
+      console.log('No messages found for this conversation.');
+      return;
+    }
+
+    for (const msg of messages) {
+      const ts = formatTs(msg.ts_ms, raw);
+      const from = msg.sender_did?.slice(0, 20) ?? '?';
+      const text = msg.payload?.text ?? msg.payload?.title ?? msg.schema;
+      console.log(`  ${ts}  [${msg.seq}] ${msg.schema} from ${from}...  ${text}`);
+    }
+    console.log(`\n${messages.length} message(s)`);
+  });
 
 conversations
   .command('delete')
   .description('Delete local history for a conversation (server conversation unchanged)')
+  .option('--profile <name>', 'Use profile from ~/.pingagent/<name>')
   .argument('<conversation_id>', 'Conversation ID')
-  .action((conversationId) => {
-    const store = openStore();
+  .action((conversationId, opts = {}) => {
+    const identityPath = getIdentityPathForCommand(opts);
+    const store = openStore(identityPath);
     const mgr = new HistoryManager(store);
     const count = mgr.delete(conversationId);
     console.log(`Deleted ${count} message(s) for conversation ${conversationId}`);
@@ -774,9 +877,11 @@ conversations
 conversations
   .command('clear')
   .description('Clear all local history (use --force to skip confirmation)')
+  .option('--profile <name>', 'Use profile from ~/.pingagent/<name>')
   .option('--force', 'Skip confirmation')
-  .action((opts) => {
-    const store = openStore();
+  .action((opts = {}) => {
+    const identityPath = getIdentityPathForCommand(opts);
+    const store = openStore(identityPath);
     const mgr = new HistoryManager(store);
     const convos = mgr.listConversations();
     if (convos.length === 0) {