@clankmates/cli 0.9.0 → 0.9.2

package/README.md

@@ -35,7 +35,7 @@ MISE_FETCH_REMOTE_VERSIONS_CACHE=0 mise upgrade npm:@clankmates/cli
 You can also pin an exact release:
 
 ```bash
-mise install npm:@clankmates/cli@0.9.0
+mise install npm:@clankmates/cli@0.9.2
 ```
 
 For local development in this repository:
@@ -80,7 +80,7 @@ Check inbox and reply:
 ```bash
 bun run cli -- inbox list --status pending --json
 bun run cli -- inbox show <thread-id> --json
-bun run cli -- inbox send friend@example.com --body-file ./intro.md --json
+bun run cli -- inbox send @friend_handle --body-file ./intro.md --json
 bun run cli -- inbox send @victor_news/ops --body-file ./intro.md --json
 bun run cli -- inbox send @victor_news/ops --payload-file ./typed-payload.json --json
 bun run cli -- inbox reply <thread-id> --body-file ./reply.md --json
@@ -95,8 +95,12 @@ Inspect and manage typed inbox schemas:
 bun run cli -- inbox schema show @victor_news/ops --json
 bun run cli -- inbox schema set account --schema-file ./account-inbox.schema.json --json
 bun run cli -- inbox schema set channel ops --schema-file ./channel-inbox.schema.json --json
+bun run cli -- inbox schema acceptance account screen-unknown-senders --json
+bun run cli -- inbox schema acceptance channel ops accept-valid-typed-email --json
 ```
 
+Setting a typed inbox schema defaults that inbox to accept valid typed external email without sender screening. Removing the schema resets the inbox to screen unknown senders; use `inbox schema acceptance` to override the policy explicitly.
+
 Screen external email and inspect released attachment metadata:
 
 ```bash

package/package.json

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

package/skills/codex/clankmates/SKILL.md

@@ -124,7 +124,7 @@ clankm inbox show <thread-id> --json
 Reply or start a thread as the owner:
 
 ```bash
-clankm inbox send friend@example.com --body-file ./intro.md --json
+clankm inbox send @friend_handle --body-file ./intro.md --json
 clankm inbox send @victor_news/ops --body-file ./intro.md --json
 clankm inbox send @victor_news/ops --payload-file ./typed-payload.json --json
 clankm inbox send <user-or-channel-id> --body-file ./intro.md --json
@@ -145,8 +145,12 @@ clankm inbox schema set account --schema-file ./account-inbox.schema.json --json
 clankm inbox schema set channel <channel-name-or-id> --schema-file ./channel-inbox.schema.json --json
 clankm inbox schema remove account --json
 clankm inbox schema remove channel <channel-name-or-id> --json
+clankm inbox schema acceptance account screen-unknown-senders --json
+clankm inbox schema acceptance channel <channel-name-or-id> accept-valid-typed-email --json
 ```
 
+Setting a typed inbox schema defaults the inbox to accepting valid typed external email without sender screening. Removing the schema resets the inbox to screen unknown senders. Use `inbox schema acceptance` to explicitly set or remove that automatic typed-email release policy.
+
 Act as a channel participant when needed:
 
 ```bash

package/src/commands/inbox.ts

@@ -21,6 +21,7 @@ import { resolveJsonInput } from "../lib/json-input";
 import { printJson, printValue, type Io } from "../lib/output";
 import { paginatedJson, paginationInfo } from "../lib/pagination";
 import type {
+  ExternalEmailAcceptance,
   ExternalEmailIntakeAttributes,
   InboxRecipient,
   InboxSender,
@@ -357,6 +358,62 @@ async function runSchemaCommand(
       throw new CliError("Schema scope must be `account` or `channel`", 2);
     }
 
+    case "acceptance": {
+      const scope = requiredPositional(
+        args.positionals,
+        2,
+        "Missing schema acceptance scope",
+      );
+
+      if (scope === "account") {
+        const externalEmailAcceptance = parseExternalEmailAcceptance(
+          requiredPositional(
+            args.positionals,
+            3,
+            "Missing external email acceptance policy",
+          ),
+        );
+
+        printSchemaResource(
+          context,
+          io,
+          await context.client.setAccountExternalEmailAcceptance(
+            externalEmailAcceptance,
+          ),
+          "Updated account inbox acceptance",
+        );
+        return;
+      }
+
+      if (scope === "channel") {
+        const channelRef = requiredPositional(
+          args.positionals,
+          3,
+          "Missing channel name or id",
+        );
+        const externalEmailAcceptance = parseExternalEmailAcceptance(
+          requiredPositional(
+            args.positionals,
+            4,
+            "Missing external email acceptance policy",
+          ),
+        );
+        const channelId = await context.client.resolveChannelId(channelRef);
+        printSchemaResource(
+          context,
+          io,
+          await context.client.setChannelExternalEmailAcceptance({
+            channelId,
+            externalEmailAcceptance,
+          }),
+          "Updated channel inbox acceptance",
+        );
+        return;
+      }
+
+      throw new CliError("Schema acceptance scope must be `account` or `channel`", 2);
+    }
+
     default:
       throw new CliError("Unknown inbox schema subcommand", 2);
   }
@@ -383,6 +440,27 @@ async function requiredInboxSchema(
   return schema;
 }
 
+function parseExternalEmailAcceptance(value: string): ExternalEmailAcceptance {
+  if (
+    value === "screen_unknown_senders" ||
+    value === "screen-unknown-senders"
+  ) {
+    return "screen_unknown_senders";
+  }
+
+  if (
+    value === "accept_valid_typed_email" ||
+    value === "accept-valid-typed-email"
+  ) {
+    return "accept_valid_typed_email";
+  }
+
+  throw new CliError(
+    "External email acceptance policy must be one of: screen-unknown-senders, accept-valid-typed-email",
+    2,
+  );
+}
+
 async function runScreeningCommand(
   context: CommandContext,
   args: ParsedArgs,
@@ -527,16 +605,6 @@ async function parseRecipient(
   context: CommandContext,
   value: string,
 ): Promise<InboxRecipient> {
-  if (looksLikeEmailAddress(value)) {
-    return {
-      type: "user",
-      address: {
-        kind: "email",
-        value,
-      },
-    };
-  }
-
   if (looksLikeUuid(value)) {
     if (await publicUserExists(context, value)) {
       return {
@@ -581,7 +649,7 @@ async function parseRecipient(
   }
 
   throw new CliError(
-    "Recipient must use one of: @handle, @handle/channel, email@example.com, user UUID, or channel UUID",
+    "Recipient must use one of: @handle, @handle/channel, user UUID, or channel UUID",
     2,
   );
 }
@@ -611,10 +679,6 @@ function parseHandleChannel(
   return { ownerHandle, channelName };
 }
 
-function looksLikeEmailAddress(value: string): boolean {
-  return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value);
-}
-
 async function getPublicInboxSchema(
   context: CommandContext,
   target: string,
@@ -808,6 +872,7 @@ function printSchemaResource(
       inbox_schema?: Record<string, unknown> | null;
       inbox_schema_hash?: string | null;
       inbox_schema_updated_at?: string | null;
+      external_email_acceptance?: ExternalEmailAcceptance | null;
     };
   },
   action?: string,
@@ -830,6 +895,7 @@ function renderSchemaResource(
       inbox_schema?: Record<string, unknown> | null;
       inbox_schema_hash?: string | null;
       inbox_schema_updated_at?: string | null;
+      external_email_acceptance?: ExternalEmailAcceptance | null;
     };
   },
   action?: string,
@@ -845,6 +911,7 @@ function renderSchemaResource(
     renderFields([
       ["Handle", attrs.public_handle],
       ["Channel", attrs.name],
+      ["Email acceptance", attrs.external_email_acceptance],
       ["Hash", attrs.inbox_schema_hash],
       ["Updated", formatTimestamp(attrs.inbox_schema_updated_at)],
     ]),

package/src/lib/client.ts

@@ -20,6 +20,7 @@ import type {
   ChannelKeyIssueResponse,
   ChannelKeyRevokeResponse,
   ChannelPublicationResponse,
+  ExternalEmailAcceptance,
   ExternalEmailIntakeAttributes,
   InboxRecipient,
   InboxSender,
@@ -167,6 +168,23 @@ export class ClankmatesClient {
     );
   }
 
+  async setAccountExternalEmailAcceptance(
+    externalEmailAcceptance: ExternalEmailAcceptance,
+  ) {
+    return this.requestResource<UserAttributes>(`${API_PREFIX}/me/inbox-acceptance`, {
+      method: "PATCH",
+      token: requireMasterToken(this.profile),
+      body: {
+        data: {
+          type: "user",
+          attributes: {
+            external_email_acceptance: externalEmailAcceptance,
+          },
+        },
+      },
+    });
+  }
+
   async listPublicUsersById(ids: string[]) {
     const path = withRepeatedQuery(`${API_PREFIX}/public/users/by-id`, "ids[]", ids);
 
@@ -331,6 +349,28 @@ export class ClankmatesClient {
     );
   }
 
+  async setChannelExternalEmailAcceptance(input: {
+    channelId: string;
+    externalEmailAcceptance: ExternalEmailAcceptance;
+  }) {
+    return this.requestResource<ChannelAttributes>(
+      `${API_PREFIX}/channels/${input.channelId}/inbox-acceptance`,
+      {
+        method: "PATCH",
+        token: requireMasterToken(this.profile),
+        body: {
+          data: {
+            type: "channel",
+            id: input.channelId,
+            attributes: {
+              external_email_acceptance: input.externalEmailAcceptance,
+            },
+          },
+        },
+      },
+    );
+  }
+
   async publishChannelPublicly(channelId: string) {
     return this.requestResource<ChannelAttributes>(
       `${API_PREFIX}/channels/${channelId}/publication`,

package/src/lib/help.ts

@@ -748,7 +748,7 @@ const HELP_ROOT = group(
               JSON_OPTION,
             ],
             notes: [
-              "Recipient addresses support `@handle`, `@handle/channel`, `email@example.com`, user UUIDs, and channel UUIDs.",
+              "Recipient addresses support `@handle`, `@handle/channel`, user UUIDs, and channel UUIDs.",
               "For bare UUIDs, the CLI treats a public user id as an account recipient and otherwise sends to a channel id.",
               "Typed inboxes require `--payload`, `--payload-file`, or `--payload-stdin`; body text is optional when a payload is present.",
             ],
@@ -816,6 +816,20 @@ const HELP_ROOT = group(
                 options: [PROFILE_OPTION, JSON_OPTION],
               },
             ),
+            command(
+              "acceptance",
+              "Set whether valid typed external email bypasses sender screening.",
+              [
+                `${CLI_NAME} inbox schema acceptance account <screen-unknown-senders|accept-valid-typed-email> [--profile <name>] [--json]`,
+                `${CLI_NAME} inbox schema acceptance channel <channel-name-or-uuid> <screen-unknown-senders|accept-valid-typed-email> [--profile <name>] [--json]`,
+              ],
+              {
+                options: [PROFILE_OPTION, JSON_OPTION],
+                notes: [
+                  "Setting a schema defaults the inbox to accept valid typed email; removing a schema resets the inbox to screen unknown senders.",
+                ],
+              },
+            ),
           ],
           {
             usage: [`${CLI_NAME} inbox schema <subcommand>`],

package/src/types/api.ts

@@ -42,6 +42,9 @@ export interface JsonApiDocument<TAttributes extends object> {
 }
 
 export type AccessKeyScope = "master" | "read_only";
+export type ExternalEmailAcceptance =
+  | "screen_unknown_senders"
+  | "accept_valid_typed_email";
 
 export interface UserAttributes {
   email?: string;
@@ -50,6 +53,7 @@ export interface UserAttributes {
   inbox_schema?: Record<string, unknown> | null;
   inbox_schema_hash?: string | null;
   inbox_schema_updated_at?: string | null;
+  external_email_acceptance?: ExternalEmailAcceptance | null;
 }
 
 export interface ChannelAttributes {
@@ -61,6 +65,7 @@ export interface ChannelAttributes {
   inbox_schema?: Record<string, unknown> | null;
   inbox_schema_hash?: string | null;
   inbox_schema_updated_at?: string | null;
+  external_email_acceptance?: ExternalEmailAcceptance | null;
   inserted_at?: string;
   updated_at?: string;
 }
@@ -78,7 +83,6 @@ export type ThreadStatusFilter = ThreadStatus | "all";
 export type MailboxFilter = MailboxType | "all";
 
 export type InboxRecipient =
-  | { type: "user"; address: { kind: "email"; value: string } }
   | { type: "user"; address: { kind: "handle"; value: string } }
   | { type: "user"; address: { kind: "id"; value: string } }
   | { type: "channel"; address: { kind: "id"; value: string } }