carlyemail 0.5.0 → 0.6.2

package/carlyemail.js

@@ -18,7 +18,7 @@ import { join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { randomBytes } from "node:crypto";
 
-export const VERSION = "0.5.0";
+export const VERSION = "0.6.2";
 
 const DEFAULT_API = "https://api.carlyemail.com";
 const CONFIG_DIR = join(homedir(), ".carlyemail");
@@ -229,6 +229,28 @@ function suggestUsername() {
   return `agent-${randomBytes(2).toString("hex")}`;
 }
 
+/**
+ * Ask the server to email a sign-in code and remember which address it went to,
+ * so a later `verify` knows to exchange the code for a key rather than confirm
+ * a sign-up. `known` distinguishes "you told me this account exists" (signup
+ * got `account_exists`) from the server's deliberately non-committal answer.
+ */
+async function startSignin(ctx, human_email, { known = false } = {}) {
+  await request(ctx.config, "POST", "/v0/agent/sign-in", {
+    auth: false,
+    body: { human_email },
+  });
+  saveConfig({ ...ctx.config, pending_signin: human_email }, ctx.configFile, ctx.configDir);
+  ctx.print(
+    arrow(
+      known
+        ? `a sign-in code is on its way to ${human_email} (good for 30 minutes), then:`
+        : `if ${human_email} has an account, a code is on its way (good for 30 minutes), then:`
+    )
+  );
+  ctx.print(`    carlyemail verify <code>`);
+}
+
 define(
   "signup",
   "Create an account and an inbox",
@@ -258,19 +280,33 @@ define(
     const display_name =
       typeof ctx.flags["display-name"] === "string" ? ctx.flags["display-name"] : undefined;
 
-    const out = await request(ctx.config, "POST", "/v0/agent/sign-up", {
-      auth: false,
-      body: { human_email, username, source: "cli", display_name },
-    });
+    let out;
+    try {
+      out = await request(ctx.config, "POST", "/v0/agent/sign-up", {
+        auth: false,
+        body: { human_email, username, source: "cli", display_name },
+      });
+    } catch (error) {
+      // An existing account is not a dead end. Fall through to the sign-in
+      // flow the same way the console does, without being asked — the person
+      // typed their address wanting a working key, not an error about which
+      // command would have produced one.
+      if (error instanceof ApiError && error.code === "account_exists") {
+        ctx.print(`${human_email} already has an account — signing in instead.`);
+        await startSignin(ctx, human_email, { known: true });
+        return;
+      }
+      throw error;
+    }
 
     // Saved before anything else is printed: the key is returned exactly once
     // and is unrecoverable afterwards, so losing it to a later crash would
     // cost the account.
-    const saved = saveConfig(
-      { ...ctx.config, api_key: out.api_key, organization_id: out.organization_id },
-      ctx.configFile,
-      ctx.configDir
-    );
+    const config = { ...ctx.config, api_key: out.api_key, organization_id: out.organization_id };
+    // A sign-in abandoned before its code arrived must not re-route the
+    // `verify` that belongs to this fresh sign-up.
+    delete config.pending_signin;
+    const saved = saveConfig(config, ctx.configFile, ctx.configDir);
 
     ctx.print(ok(bold(out.inbox_id)));
     ctx.print(ok(`key saved to ${saved}`));
@@ -278,7 +314,22 @@ define(
     ctx.print(arrow(`check ${human_email} for a 6-digit code, then:`));
     ctx.print(`    carlyemail verify <code>`);
     ctx.print("");
-    ctx.print(dim("Until it is confirmed the account can read its own mail but not send."));
+    ctx.print(dim(`Until the code is confirmed the account can only email ${human_email}.`));
+  }
+);
+
+define(
+  "signin",
+  "Sign in to an existing account with an emailed code",
+  "carlyemail signin you@example.com",
+  async (ctx) => {
+    let human_email = ctx.positional[0] || ctx.flags["human-email"];
+    if (typeof human_email !== "string" || !human_email) {
+      const answer = await ctx.ask("The account's owner email: ");
+      if (answer) human_email = answer;
+    }
+    if (!human_email) throw new UsageError("carlyemail signin you@example.com");
+    await startSignin(ctx, human_email);
   }
 );
 
@@ -286,8 +337,24 @@ define("verify", "Confirm the owner email with the code", "carlyemail verify 123
   const code = ctx.positional[0] || ctx.flags.code;
   if (!code) throw new UsageError("the 6-digit code is required: carlyemail verify 123456");
 
+  // A pending sign-in and a sign-up confirmation are the same step to the
+  // person typing the code, but different calls: one trades the code for a new
+  // key, the other upgrades the key sign-up already saved. The config
+  // remembers which one is open.
+  if (ctx.config.pending_signin) {
+    const out = await request(ctx.config, "POST", "/v0/agent/sign-in/verify", {
+      auth: false,
+      body: { human_email: ctx.config.pending_signin, otp_code: String(code) },
+    });
+    const config = { ...ctx.config, api_key: out.api_key, organization_id: out.organization_id };
+    delete config.pending_signin;
+    const saved = saveConfig(config, ctx.configFile, ctx.configDir);
+    ctx.print(ok(`signed in — key saved to ${saved}`));
+    return;
+  }
+
   await request(ctx.config, "POST", "/v0/agent/verify", { body: { otp_code: String(code) } });
-  ctx.print(ok("verified — this account can send now"));
+  ctx.print(ok("verified — this account can send anywhere now"));
 });
 
 define("whoami", "Show the key's identity and scope", "carlyemail whoami", async (ctx) => {
@@ -726,9 +793,9 @@ define("plan", "Show the current plan and its limits", "carlyemail plan", async
   ctx.print(`  ${dim("email")}     ${cap(billing.monthly_emails)} a month`);
 });
 
-define("upgrade", "Get a checkout link for a paid plan", "carlyemail upgrade developer", async (ctx) => {
+define("upgrade", "Get a checkout link for a paid plan", "carlyemail upgrade startup", async (ctx) => {
   const plan = ctx.positional[0] || ctx.flags.plan;
-  if (!plan) throw new UsageError("which plan? carlyemail upgrade developer|startup");
+  if (!plan) throw new UsageError("which plan? carlyemail upgrade startup|business");
   const out = await request(ctx.config, "POST", "/v0/billing/checkout", { body: { plan } });
   emit(ctx, out, () => {
     ctx.print(arrow("open this to upgrade:"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "carlyemail",
-  "version": "0.5.0",
+  "version": "0.6.2",
   "description": "Real email inboxes your agent can send, receive and reply from. SDK and CLI.",
   "keywords": [
     "email",
@@ -11,7 +11,7 @@
     "mcp",
     "cli"
   ],
-  "homepage": "https://carlyemail.com",
+  "homepage": "https://docs.carlyemail.com",
   "bugs": "https://docs.carlyemail.com/support",
   "repository": {
     "type": "git",
@@ -22,7 +22,7 @@
   "author": "SWH Labs LLC",
   "type": "module",
   "bin": {
-    "carlyemail": "./carlyemail.js"
+    "carlyemail": "carlyemail.js"
   },
   "types": "./sdk.d.ts",
   "exports": {

package/sdk.d.ts

@@ -16,6 +16,8 @@ export interface AgentSigninVerifyRequest {
 export interface AgentSigninVerifyResponse {
   organization_id: string;
   api_key: string;
+  inbox_domain?: string | null;
+  inboxes_on_signup_domain?: Array<string>;
 }
 
 export interface AgentSignupRequest {
@@ -39,6 +41,8 @@ export interface AgentVerifyRequest {
 export interface AgentVerifyResponse {
   organization_id: string;
   verified: boolean;
+  inbox_domain?: string | null;
+  inboxes_on_signup_domain?: Array<string>;
 }
 
 export interface ApiKeyOut {
@@ -50,6 +54,7 @@ export interface ApiKeyOut {
   used_at?: string | null;
   permissions?: Record<string, boolean> | null;
   created_at: string;
+  expires_at?: string | null;
 }
 
 export interface AttachmentOut {
@@ -97,6 +102,7 @@ export interface BatchUpdateMessagesResponse {
 export interface CreateApiKeyRequest {
   name?: string | null;
   permissions?: Record<string, boolean> | null;
+  expires_at?: string | null;
 }
 
 export interface CreateApiKeyResponse {
@@ -108,6 +114,7 @@ export interface CreateApiKeyResponse {
   inbox_id?: string | null;
   permissions?: Record<string, boolean> | null;
   created_at: string;
+  expires_at?: string | null;
 }
 
 export interface CreateDomainRequest {
@@ -204,6 +211,26 @@ export interface DraftOut {
   created_at: string;
 }
 
+export interface EventOut {
+  event_id: string;
+  event_type: string;
+  organization_id: string;
+  pod_id?: string | null;
+  inbox_id?: string | null;
+  message_id?: string | null;
+  thread_id?: string | null;
+  payload?: Record<string, unknown>;
+  created_at: string;
+}
+
+export interface FeedbackRequest {
+  message: string;
+}
+
+export interface FeedbackResponse {
+  received: boolean;
+}
+
 export interface ForwardMessageRequest {
   to?: Array<string> | string | null;
   cc?: Array<string> | string | null;
@@ -286,6 +313,13 @@ export interface ListEntryOut {
   created_at: string;
 }
 
+export interface ListEventsResponse {
+  count: number;
+  limit?: number | null;
+  next_page_token?: string | null;
+  events: Array<EventOut>;
+}
+
 export interface ListInboxEventsResponse {
   count: number;
   limit?: number | null;
@@ -328,6 +362,11 @@ export interface ListThreadsResponse {
   threads: Array<ThreadItem>;
 }
 
+export interface ListWebhookAttemptsResponse {
+  count: number;
+  attempts: Array<WebhookAttemptOut>;
+}
+
 export interface ListWebhooksResponse {
   count: number;
   limit?: number | null;
@@ -378,6 +417,7 @@ export interface MessageOut {
   in_reply_to?: string | null;
   references?: Array<string>;
   headers?: Record<string, unknown>;
+  authentication?: Record<string, string>;
 }
 
 export interface OrganizationOut {
@@ -587,6 +627,19 @@ export interface VerificationRecord {
   priority?: number | null;
 }
 
+export interface WebhookAttemptOut {
+  attempt_id: string;
+  webhook_id: string;
+  event_id: string;
+  event_type: string;
+  url: string;
+  status_code?: number | null;
+  ok: boolean;
+  detail?: string | null;
+  duration_ms: number;
+  created_at: string;
+}
+
 export interface WebhookHeadersResponse {
   header_names: Array<string>;
 }
@@ -635,6 +688,10 @@ export declare class Billing {
   current(): Promise<Record<string, unknown>>;
 }
 
+export declare class Feedback {
+  send(body: FeedbackRequest): Promise<FeedbackResponse>;
+}
+
 export declare class Inboxes {
   list(query?: { limit?: number | null; pageToken?: string | null; ascending?: boolean }): Promise<ListInboxesResponse>;
   create(body: CreateInboxRequest): Promise<InboxOut>;
@@ -717,6 +774,10 @@ export declare class ApiKeys {
   deleteInbox(inboxId: string, apiKeyId: string): Promise<void>;
 }
 
+export declare class Events {
+  list(query?: { eventTypes?: Array<string> | null; inboxId?: string | null; start?: string | null; end?: string | null; limit?: number | null; pageToken?: string | null }): Promise<ListEventsResponse>;
+}
+
 export declare class Metrics {
   orgEvents(query?: { eventTypes?: Array<string> | null; start?: string | null; end?: string | null; period?: number | null; limit?: number | null; descending?: boolean }): Promise<Record<string, unknown>>;
   orgUsage(query?: { usageTypes?: Array<string> | null; start?: string | null; end?: string | null; period?: number | null; limit?: number | null; descending?: boolean }): Promise<Record<string, unknown>>;
@@ -779,6 +840,8 @@ export declare class InboxEvents {
 export declare class Webhooks {
   list(query?: { limit?: number | null; pageToken?: string | null; ascending?: boolean }): Promise<ListWebhooksResponse>;
   create(body: CreateWebhookRequest): Promise<WebhookOut>;
+  listAllAttempts(query?: { limit?: number }): Promise<ListWebhookAttemptsResponse>;
+  listAttempts(webhookId: string, query?: { limit?: number }): Promise<ListWebhookAttemptsResponse>;
   get(webhookId: string): Promise<WebhookOut>;
   update(webhookId: string, body: UpdateWebhookRequest): Promise<WebhookOut>;
   delete(webhookId: string): Promise<void>;
@@ -798,6 +861,7 @@ export declare class CarlyEmail {
   agent: Agent;
   auth: Auth;
   billing: Billing;
+  feedback: Feedback;
   inboxes: Inboxes;
   messages: Messages;
   threads: Threads;
@@ -805,6 +869,7 @@ export declare class CarlyEmail {
   lists: Lists;
   domains: Domains;
   apiKeys: ApiKeys;
+  events: Events;
   metrics: Metrics;
   pods: Pods;
   organizations: Organizations;

package/sdk.js

@@ -126,6 +126,17 @@ class Billing {
   }
 }
 
+class Feedback {
+  constructor(transport) {
+    this.$ = transport;
+  }
+
+  /** Send Feedback */
+  send(body) {
+    return this.$.request("POST", `/v0/feedback`, { body });
+  }
+}
+
 class Inboxes {
   constructor(transport) {
     this.$ = transport;
@@ -473,6 +484,17 @@ class ApiKeys {
   }
 }
 
+class Events {
+  constructor(transport) {
+    this.$ = transport;
+  }
+
+  /** List Events */
+  list(query = {}) {
+    return this.$.request("GET", `/v0/events`, { query: { "event_types": query.eventTypes, "inbox_id": query.inboxId, "start": query.start, "end": query.end, "limit": query.limit, "page_token": query.pageToken } });
+  }
+}
+
 class Metrics {
   constructor(transport) {
     this.$ = transport;
@@ -747,6 +769,16 @@ class Webhooks {
     return this.$.request("POST", `/v0/webhooks`, { body });
   }
 
+  /** List All Attempts */
+  listAllAttempts(query = {}) {
+    return this.$.request("GET", `/v0/webhooks/attempts`, { query: { "limit": query.limit } });
+  }
+
+  /** List Attempts */
+  listAttempts(webhookId, query = {}) {
+    return this.$.request("GET", `/v0/webhooks/${encode(webhookId)}/attempts`, { query: { "limit": query.limit } });
+  }
+
   /** Get Webhook */
   get(webhookId) {
     return this.$.request("GET", `/v0/webhooks/${encode(webhookId)}`);
@@ -814,6 +846,7 @@ export class CarlyEmail {
     this.agent = new Agent(transport);
     this.auth = new Auth(transport);
     this.billing = new Billing(transport);
+    this.feedback = new Feedback(transport);
     this.inboxes = new Inboxes(transport);
     this.messages = new Messages(transport);
     this.threads = new Threads(transport);
@@ -821,6 +854,7 @@ export class CarlyEmail {
     this.lists = new Lists(transport);
     this.domains = new Domains(transport);
     this.apiKeys = new ApiKeys(transport);
+    this.events = new Events(transport);
     this.metrics = new Metrics(transport);
     this.pods = new Pods(transport);
     this.organizations = new Organizations(transport);