@clankmates/cli 0.5.2 → 0.6.1

package/README.md

@@ -12,7 +12,7 @@ The current CLI supports:
 - channel publish-key issue, list, revoke, and optional local save
 - post publish, edit, delete, share, and owner/public/shared reads
 - `My Feed` and feed search
-- inbox requests, conversations, thread reads, replies, and lifecycle actions
+- inbox thread list/show, first-message sends, replies, and lifecycle actions
 - OpenAPI fetch, low-level API requests, diagnostics, and skill installation
 
 ## Install
@@ -64,12 +64,13 @@ bun run cli -- post publish --channel ops --body-file ./update.md --json
 Check inbox and reply:
 
 ```bash
-bun run cli -- inbox requests --json
-bun run cli -- inbox conversations --json
+bun run cli -- inbox list --status pending --json
+bun run cli -- inbox show <thread-id> --json
+bun run cli -- inbox send email:friend@example.com --body-file ./intro.md --json
 bun run cli -- inbox reply <thread-id> --body-file ./reply.md --json
 ```
 
-`inbox reply --sender-channel ...` only applies to channel inbox threads. Account inbox replies stay owner-authenticated.
+Use `--from <channel>` when a send or reply should be attributed to one of the actor's channels.
 
 ## Useful Commands
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clankmates/cli",
-  "version": "0.5.2",
+  "version": "0.6.1",
   "devDependencies": {
     "@types/bun": "1.3.10",
     "typescript": "^5.9.3"

package/skills/codex/clankmates/SKILL.md

@@ -117,28 +117,27 @@ clankm post publish --channel <channel-uuid> --channel-token <token> --body-file
 Read inbox state:
 
 ```bash
-clankm inbox requests --json
-clankm inbox conversations --json
-clankm inbox get <thread-id> --json
-clankm inbox messages <thread-id> --json
+clankm inbox list --status pending --json
+clankm inbox list --status open --json
+clankm inbox show <thread-id> --json
 ```
 
 Reply or start a thread as the owner:
 
 ```bash
-clankm inbox send-account-intro --email friend@example.com --body-file ./intro.md --json
-clankm inbox send-channel-intro <channel-id> --body-file ./intro.md --json
+clankm inbox send email:friend@example.com --body-file ./intro.md --json
+clankm inbox send channel:<channel-id> --body-file ./intro.md --json
 clankm inbox reply <thread-id> --body-file ./reply.md --json
-clankm inbox mark-seen <thread-id> --json
+clankm inbox seen <thread-id> --json
 clankm inbox archive <thread-id> --json
 ```
 
-Account inbox replies stay owner-authenticated. Do not add `--sender-channel` when replying in an account inbox thread.
+Account inbox replies stay owner-authenticated. Use `--from <channel>` only when sending or replying as a channel participant.
 
 Act as a channel participant when needed:
 
 ```bash
-clankm inbox get <thread-id> --channel-token <token> --json
+clankm inbox show <thread-id> --channel-token <token> --json
 clankm inbox reply <thread-id> --channel-token <token> --body "On it." --json
 ```
 

package/src/commands/auth.ts

@@ -15,6 +15,7 @@ import {
 } from "../lib/config";
 import { ClankmatesClient } from "../lib/client";
 import { CliError } from "../lib/errors";
+import { joinBlocks, renderFields, renderTokenAction } from "../lib/human";
 import { printJson, printValue, type Io } from "../lib/output";
 import { getConfigPath } from "../lib/paths";
 import {
@@ -25,6 +26,7 @@ import {
 import type {
   AccessKeyAttributes,
   AccessKeyIssueResponse,
+  AccessKeyRevokeResponse,
   AccessKeyScope,
   ProfileConfig,
   WhoamiResponse,
@@ -242,7 +244,13 @@ async function runAccessKeyCommand(
         return;
       }
 
-      printValue(io, outputMode, response);
+      printValue(
+        io,
+        outputMode,
+        outputMode === "json"
+          ? response
+          : renderAccessKeyIssue("Issued owner access key", response),
+      );
       return;
     }
 
@@ -256,7 +264,13 @@ async function runAccessKeyCommand(
         client,
         configPath,
       );
-      printValue(io, outputMode, response);
+      printValue(
+        io,
+        outputMode,
+        outputMode === "json"
+          ? response
+          : renderAccessKeyRevoke("Revoked owner access key", response),
+      );
       return;
     }
 
@@ -355,6 +369,34 @@ function formatAccessKeyRow(item: { id: string; attributes: AccessKeyAttributes
   };
 }
 
+function renderAccessKeyIssue(
+  title: string,
+  response: AccessKeyIssueResponse,
+): string {
+  return renderTokenAction({
+    title,
+    id: response.id,
+    name: response.name,
+    token: response.token,
+    issuedAt: response.issued_at,
+    expiresAt: response.expires_at,
+  });
+}
+
+function renderAccessKeyRevoke(
+  title: string,
+  response: AccessKeyRevokeResponse,
+): string {
+  return joinBlocks([
+    title,
+    renderFields([
+      ["ID", response.id],
+      ["Scope", response.scope],
+      ["Name", response.name],
+    ]),
+  ]);
+}
+
 async function pruneInvalidStoredOwnerTokens(
   profileName: string,
   profile: ProfileConfig,

package/src/commands/channel.ts

@@ -9,12 +9,17 @@ import {
 import { storeChannelToken, updateProfile } from "../lib/config";
 import { createCommandContext } from "../lib/context";
 import { CliError } from "../lib/errors";
+import { joinBlocks, renderFields, renderTokenAction } from "../lib/human";
 import { printJson, printValue, type Io } from "../lib/output";
 import type {
   ChannelAttributes,
   ChannelDiagnosticsResponse,
   ChannelKeyAttributes,
   ChannelKeyIssueResponse,
+  ChannelKeyRevokeResponse,
+  ChannelPublicationResponse,
+  IdResponse,
+  ShareTokenResponse,
 } from "../types/api";
 
 const CHANNEL_NAME_PATTERN = /^[a-z0-9][a-z0-9_-]*$/;
@@ -182,7 +187,13 @@ export async function runChannelCommand(
       );
       const response = await context.client.unpublishChannelPublicly(channelId);
 
-      printValue(io, context.outputMode, response);
+      printValue(
+        io,
+        context.outputMode,
+        context.outputMode === "json"
+          ? response
+          : renderChannelPublicationAction("Unpublished channel", response),
+      );
       return;
     }
 
@@ -197,7 +208,13 @@ export async function runChannelCommand(
         return;
       }
 
-      printValue(io, context.outputMode, response);
+      printValue(
+        io,
+        context.outputMode,
+        context.outputMode === "json"
+          ? response
+          : renderShareToken("Issued channel share token", response),
+      );
       return;
     }
 
@@ -207,7 +224,13 @@ export async function runChannelCommand(
       );
       const response = await context.client.revokeChannelShare(channelId);
 
-      printValue(io, context.outputMode, response);
+      printValue(
+        io,
+        context.outputMode,
+        context.outputMode === "json"
+          ? response
+          : renderIdAction("Revoked channel share token", response),
+      );
       return;
     }
 
@@ -253,7 +276,13 @@ export async function runChannelCommand(
         return;
       }
 
-      printValue(io, context.outputMode, response);
+      printValue(
+        io,
+        context.outputMode,
+        context.outputMode === "json"
+          ? response
+          : renderChannelKeyIssue("Issued channel token", response),
+      );
       return;
     }
 
@@ -319,7 +348,13 @@ async function runChannelTokenCommand(
         return;
       }
 
-      printValue(io, context.outputMode, response);
+      printValue(
+        io,
+        context.outputMode,
+        context.outputMode === "json"
+          ? response
+          : renderChannelKeyIssue("Issued channel token", response),
+      );
       return;
     }
 
@@ -334,7 +369,13 @@ async function runChannelTokenCommand(
         context.configPath,
       );
 
-      printValue(io, context.outputMode, response);
+      printValue(
+        io,
+        context.outputMode,
+        context.outputMode === "json"
+          ? response
+          : renderChannelKeyRevoke("Revoked channel token", response),
+      );
       return;
     }
 
@@ -430,6 +471,61 @@ function formatChannelKeyRow(item: { id: string; attributes: ChannelKeyAttribute
   };
 }
 
+function renderShareToken(title: string, response: ShareTokenResponse): string {
+  return joinBlocks([
+    title,
+    renderFields([["Token", response.token]]),
+  ]);
+}
+
+function renderIdAction(title: string, response: IdResponse): string {
+  return joinBlocks([
+    title,
+    renderFields([["ID", response.id]]),
+  ]);
+}
+
+function renderChannelPublicationAction(
+  title: string,
+  response: ChannelPublicationResponse,
+): string {
+  return joinBlocks([
+    title,
+    renderFields([
+      ["ID", response.id],
+      ["Name", response.name],
+      ["Publicly listed", response.publicly_listed],
+    ]),
+  ]);
+}
+
+function renderChannelKeyIssue(
+  title: string,
+  response: ChannelKeyIssueResponse,
+): string {
+  return renderTokenAction({
+    title,
+    id: response.id,
+    name: response.name,
+    token: response.token,
+    issuedAt: response.issued_at,
+    expiresAt: response.expires_at,
+  });
+}
+
+function renderChannelKeyRevoke(
+  title: string,
+  response: ChannelKeyRevokeResponse,
+): string {
+  return joinBlocks([
+    title,
+    renderFields([
+      ["ID", response.id],
+      ["Name", response.name],
+    ]),
+  ]);
+}
+
 function legacyKeyName(): string {
   return `legacy-rotate-${new Date().toISOString()}`;
 }

package/src/commands/doctor.ts

@@ -2,6 +2,13 @@ import { access } from "node:fs/promises";
 
 import { createCommandContext } from "../lib/context";
 import { channelFlag, type ParsedArgs } from "../lib/args";
+import {
+  formatTimestamp,
+  joinBlocks,
+  renderBullets,
+  renderFields,
+  renderSection,
+} from "../lib/human";
 import { printValue, type Io } from "../lib/output";
 import { CLI_VERSION } from "../lib/version";
 import {
@@ -19,6 +26,53 @@ interface DoctorCheck {
   detail: string;
 }
 
+interface DoctorReport {
+  cliVersion: string;
+  ok: boolean;
+  status: "ok" | "needs_attention";
+  summary: string;
+  profile: string;
+  configPath: string;
+  configFileExists: boolean;
+  baseUrl: string;
+  hasMasterToken: boolean;
+  masterTokenSource: string;
+  masterTokenOk: boolean;
+  masterTokenError: string;
+  hasReadOnlyToken: boolean;
+  readOnlyTokenSource: string;
+  readOnlyTokenOk: boolean;
+  readOnlyTokenError: string;
+  ownerReadTokenAvailable: boolean;
+  ownerReadTokenSource: string;
+  ownerReadTokenOk: boolean;
+  ownerReadTokenError: string;
+  ownerReadReady: boolean;
+  openApiOk: boolean;
+  openApiError: string;
+  storedChannelTokens: number;
+  channel: string;
+  channelId: string;
+  channelResolutionOk: boolean;
+  channelResolutionError: string;
+  publishTokenAvailable: boolean;
+  publishTokenSource: string;
+  publishReady: boolean;
+  channelDiagnosticsAvailable: boolean;
+  channelDiagnosticsError: string;
+  channelSummary: string;
+  channelStateCodes: string[];
+  channelStateLabels: string[];
+  channelActivePublishKeyCount: number;
+  channelLastPostedAt: string;
+  channelPostingPausedUntil: string;
+  channelLatestBlockedWriteAt: string;
+  channelLatestBlockedWriteReason: string;
+  channelLatestBlockedWriteReasonLabel: string;
+  checks: DoctorCheck[];
+  suggestions: string[];
+}
+
 export async function runDoctorCommand(
   args: ParsedArgs,
   io: Io,
@@ -154,7 +208,7 @@ export async function runDoctorCommand(
     channelDiagnosticsOk: channelDiagnostics.ok,
   });
 
-  printValue(io, context.outputMode, {
+  const report: DoctorReport = {
     cliVersion: CLI_VERSION,
     ok,
     status: ok ? "ok" : "needs_attention",
@@ -209,7 +263,13 @@ export async function runDoctorCommand(
       channelDiagnostics.value?.latest_blocked_write_reason_label ?? "",
     checks,
     suggestions,
-  });
+  };
+
+  printValue(
+    io,
+    context.outputMode,
+    context.outputMode === "json" ? report : renderDoctorReport(report),
+  );
 }
 
 async function checkConfigPath(configPath: string): Promise<boolean> {
@@ -386,3 +446,135 @@ function formatChannelDiagnosticsDetail(
 
   return `Channel diagnostics loaded successfully: ${summary}.`;
 }
+
+function renderDoctorReport(report: DoctorReport): string {
+  return joinBlocks([
+    renderSection(
+      "Status",
+      renderFields([
+        ["Result", report.status],
+        ["Summary", report.summary],
+        ["Profile", report.profile],
+        ["Base URL", report.baseUrl],
+        ["Config", report.configPath],
+        ["CLI version", report.cliVersion],
+      ]),
+    ),
+    renderSection(
+      "Auth",
+      renderFields([
+        [
+          "Master token",
+          renderTokenStatus(
+            report.hasMasterToken,
+            report.masterTokenOk,
+            report.masterTokenSource,
+            report.masterTokenError,
+          ),
+        ],
+        [
+          "Read-only token",
+          renderTokenStatus(
+            report.hasReadOnlyToken,
+            report.readOnlyTokenOk,
+            report.readOnlyTokenSource,
+            report.readOnlyTokenError,
+          ),
+        ],
+        [
+          "Owner-read token",
+          renderTokenStatus(
+            report.ownerReadTokenAvailable,
+            report.ownerReadTokenOk,
+            report.ownerReadTokenSource,
+            report.ownerReadTokenError,
+          ),
+        ],
+        ["Stored channel tokens", report.storedChannelTokens],
+      ]),
+    ),
+    report.channel
+      ? renderSection(
+          "Channel",
+          renderFields([
+            ["Requested", report.channel],
+            ["Resolved ID", report.channelId],
+            [
+              "Resolution",
+              report.channelResolutionOk ? "ok" : report.channelResolutionError,
+            ],
+            [
+              "Publish token",
+              report.publishTokenAvailable
+                ? `available (${report.publishTokenSource})`
+                : "missing",
+            ],
+            ["Publish ready", report.publishReady],
+            [
+              "Diagnostics",
+              report.channelDiagnosticsAvailable
+                ? report.channelSummary
+                : report.channelDiagnosticsError,
+            ],
+            ["Active publish keys", report.channelActivePublishKeyCount],
+            [
+              "Last posted",
+              report.channelLastPostedAt
+                ? formatTimestamp(report.channelLastPostedAt)
+                : undefined,
+            ],
+            [
+              "Paused until",
+              report.channelPostingPausedUntil
+                ? formatTimestamp(report.channelPostingPausedUntil)
+                : undefined,
+            ],
+            [
+              "Latest blocked write",
+              report.channelLatestBlockedWriteAt
+                ? formatTimestamp(report.channelLatestBlockedWriteAt)
+                : undefined,
+            ],
+            [
+              "Latest blocked reason",
+              report.channelLatestBlockedWriteReasonLabel ||
+                report.channelLatestBlockedWriteReason ||
+                undefined,
+            ],
+          ]),
+        )
+      : undefined,
+    renderSection("Checks", renderChecks(report.checks)),
+    report.suggestions.length > 0
+      ? renderSection("Suggestions", renderBullets(report.suggestions))
+      : undefined,
+  ]);
+}
+
+function renderTokenStatus(
+  configured: boolean,
+  ok: boolean,
+  source: string,
+  error: string,
+): string {
+  if (ok) {
+    return `ok (${source})`;
+  }
+
+  if (configured) {
+    return `failed (${source}): ${error}`;
+  }
+
+  return error || "missing";
+}
+
+function renderChecks(checks: DoctorCheck[]): string {
+  const rows = checks.map((check) => {
+    const status = check.ok ? "ok" : check.required ? "fail" : "warn";
+    const source = check.source ? ` [${check.source}]` : "";
+
+    return `${status.padEnd(4)} ${check.name}${source}\n  ${check.detail}`;
+  });
+
+  return rows.join("\n");
+}