@inkbox/cli 0.2.5 → 0.2.7

package/README.md

@@ -48,6 +48,25 @@ inkbox --json identity list
 
 ## Commands
 
+### signup
+
+Agent self-signup flow. The `create` command does not require an API key.
+
+```bash
+inkbox signup create                             # Register a new agent (no API key needed)
+  --human-email <email>                          #   Email of the human to approve (required)
+  --display-name <name>                          #   Agent display name (required)
+  --note-to-human <note>                         #   Message to human in verification email (required)
+
+inkbox signup verify                             # Submit verification code
+  --code <code>                                  #   6-digit code from email (required)
+
+inkbox signup resend-verification                # Resend the verification email (5-min cooldown)
+                                                 # Returns current organization_id (may change after verify/approval)
+
+inkbox signup status                             # Check claim status and restrictions
+```
+
 ### identity
 
 Manage agent identities.
@@ -261,6 +280,15 @@ inkbox number update <id>                    # Update phone number config
 inkbox number release <number-id>             # Release a phone number
 ```
 
+### whoami
+
+Show the authenticated caller's identity.
+
+```bash
+inkbox whoami                                # Display caller identity (API key or JWT)
+inkbox whoami --json                         # Output as JSON
+```
+
 ### signing-key
 
 Webhook signing key management.

package/dist/commands/signup.js

@@ -0,0 +1,92 @@
+import { getGlobalOpts } from "../client.js";
+import { output } from "../output.js";
+import { withErrorHandler } from "../errors.js";
+import { Inkbox } from "@inkbox/sdk";
+function requireApiKey(opts) {
+    const apiKey = opts.apiKey ?? process.env.INKBOX_API_KEY;
+    if (!apiKey) {
+        console.error("Error: API key required. Set INKBOX_API_KEY or pass --api-key.");
+        process.exit(1);
+    }
+    return apiKey;
+}
+export function registerSignupCommands(program) {
+    const signup = program
+        .command("signup")
+        .description("Agent self-signup flow");
+    signup
+        .command("create")
+        .description("Register a new agent (no API key required)")
+        .requiredOption("--human-email <email>", "Email of the human who should approve this agent")
+        .requiredOption("--display-name <name>", "Human-readable name for the agent")
+        .requiredOption("--note-to-human <note>", "Message from the agent to the human, included in the verification email")
+        .action(withErrorHandler(async function () {
+        const globalOpts = getGlobalOpts(this);
+        const cmdOpts = this.opts();
+        const result = await Inkbox.signup({
+            humanEmail: cmdOpts.humanEmail,
+            displayName: cmdOpts.displayName,
+            noteToHuman: cmdOpts.noteToHuman,
+        }, { baseUrl: globalOpts.baseUrl });
+        if (globalOpts.json) {
+            output(result, { json: true });
+        }
+        else {
+            console.log();
+            console.log("Agent registered successfully!");
+            console.log();
+            console.log(`  Email:    ${result.emailAddress}`);
+            console.log(`  Handle:   ${result.agentHandle}`);
+            console.log(`  Org:      ${result.organizationId}`);
+            console.log(`  Status:   ${result.claimStatus}`);
+            console.log();
+            console.log(`  API Key:  ${result.apiKey}`);
+            console.log();
+            console.log("Save the API key — it is shown only once.");
+            console.log(`A verification email has been sent to ${result.humanEmail}.`);
+        }
+    }));
+    signup
+        .command("verify")
+        .description("Submit a 6-digit verification code")
+        .requiredOption("--code <code>", "The 6-digit verification code")
+        .action(withErrorHandler(async function () {
+        const globalOpts = getGlobalOpts(this);
+        const apiKey = requireApiKey(globalOpts);
+        const cmdOpts = this.opts();
+        const result = await Inkbox.verifySignup(apiKey, { verificationCode: cmdOpts.code }, { baseUrl: globalOpts.baseUrl });
+        output(result, { json: !!globalOpts.json });
+    }));
+    signup
+        .command("resend-verification")
+        .description("Resend the verification email (5-minute cooldown)")
+        .action(withErrorHandler(async function () {
+        const globalOpts = getGlobalOpts(this);
+        const apiKey = requireApiKey(globalOpts);
+        const result = await Inkbox.resendSignupVerification(apiKey, { baseUrl: globalOpts.baseUrl });
+        output(result, { json: !!globalOpts.json });
+    }));
+    signup
+        .command("status")
+        .description("Check signup claim status and restrictions")
+        .action(withErrorHandler(async function () {
+        const globalOpts = getGlobalOpts(this);
+        const apiKey = requireApiKey(globalOpts);
+        const result = await Inkbox.getSignupStatus(apiKey, { baseUrl: globalOpts.baseUrl });
+        if (globalOpts.json) {
+            output(result, { json: true });
+        }
+        else {
+            output({
+                claimStatus: result.claimStatus,
+                humanState: result.humanState,
+                humanEmail: result.humanEmail,
+                maxSendsPerDay: result.restrictions.maxSendsPerDay,
+                allowedRecipients: result.restrictions.allowedRecipients.join(", ") || "-",
+                canReceive: result.restrictions.canReceive,
+                canCreateMailboxes: result.restrictions.canCreateMailboxes,
+            }, { json: false });
+        }
+    }));
+}
+//# sourceMappingURL=signup.js.map

package/dist/commands/signup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signup.js","sourceRoot":"","sources":["../../src/commands/signup.ts"],"names":[],"mappings":"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"}

package/dist/commands/whoami.js

@@ -0,0 +1,15 @@
+import { createClient, getGlobalOpts } from "../client.js";
+import { output } from "../output.js";
+import { withErrorHandler } from "../errors.js";
+export function registerWhoamiCommand(program) {
+    program
+        .command("whoami")
+        .description("Show the authenticated caller's identity")
+        .action(withErrorHandler(async function () {
+        const opts = getGlobalOpts(this);
+        const inkbox = createClient(opts);
+        const info = await inkbox.whoami();
+        output(info, { json: !!opts.json });
+    }));
+}
+//# sourceMappingURL=whoami.js.map

package/dist/commands/whoami.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whoami.js","sourceRoot":"","sources":["../../src/commands/whoami.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,0CAA0C,CAAC;SACvD,MAAM,CACL,gBAAgB,CAAC,KAAK;QACpB,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC,CAAC,CACH,CAAC;AACN,CAAC"}

package/dist/index.js

@@ -1,5 +1,7 @@
 #!/usr/bin/env node
 import { Command } from "commander";
+import { registerWhoamiCommand } from "./commands/whoami.js";
+import { registerSignupCommands } from "./commands/signup.js";
 import { registerIdentityCommands } from "./commands/identity.js";
 import { registerEmailCommands } from "./commands/email.js";
 import { registerPhoneCommands } from "./commands/phone.js";
@@ -17,6 +19,8 @@ const program = new Command()
     .option("--vault-key <key>", "Vault key for decrypt operations (or set INKBOX_VAULT_KEY)")
     .option("--base-url <url>", "Override API base URL")
     .option("--json", "Output as JSON", false);
+registerWhoamiCommand(program);
+registerSignupCommands(program);
 registerIdentityCommands(program);
 registerEmailCommands(program);
 registerPhoneCommands(program);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE;KAC1B,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CAAC,4EAA4E,CAAC;KACzF,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,iBAAiB,EAAE,wCAAwC,CAAC;KACnE,MAAM,CAAC,mBAAmB,EAAE,4DAA4D,CAAC;KACzF,MAAM,CAAC,kBAAkB,EAAE,uBAAuB,CAAC;KACnD,MAAM,CAAC,QAAQ,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;AAE7C,wBAAwB,CAAC,OAAO,CAAC,CAAC;AAClC,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,uBAAuB,CAAC,OAAO,CAAC,CAAC;AACjC,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,0BAA0B,CAAC,OAAO,CAAC,CAAC;AACpC,uBAAuB,CAAC,OAAO,CAAC,CAAC;AAEjC,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE;KAC1B,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CAAC,4EAA4E,CAAC;KACzF,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,iBAAiB,EAAE,wCAAwC,CAAC;KACnE,MAAM,CAAC,mBAAmB,EAAE,4DAA4D,CAAC;KACzF,MAAM,CAAC,kBAAkB,EAAE,uBAAuB,CAAC;KACnD,MAAM,CAAC,QAAQ,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;AAE7C,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,wBAAwB,CAAC,OAAO,CAAC,CAAC;AAClC,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,uBAAuB,CAAC,OAAO,CAAC,CAAC;AACjC,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,0BAA0B,CAAC,OAAO,CAAC,CAAC;AACpC,uBAAuB,CAAC,OAAO,CAAC,CAAC;AAEjC,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkbox/cli",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "description": "CLI for the Inkbox API",
   "license": "MIT",
   "type": "module",
@@ -17,7 +17,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@inkbox/sdk": "^0.2.5",
+    "@inkbox/sdk": "^0.2.7",
     "commander": "^13.0.0"
   },
   "devDependencies": {