@gravity-rail/cli 0.6.0 → 0.7.0

package/README.md

@@ -161,6 +161,13 @@ cat member.json | gr members update -w $WORKSPACE --id 42 --allow-write
 | `calendars` | Scheduling — calendars, events, event types, availability, Google sync |
 | `qualifications` | Skills evaluation — requirements, submissions, scoring |
 
+### Global (no workspace)
+
+| Domain | Description |
+|---|---|
+| `concierge` | Global Concierge — interactive chat, PSTN `--call`, SMS `--sms` |
+| `account verify-phone` | Verify your account phone (required before concierge outbound) |
+
 ### Communication
 
 | Domain | Description |
@@ -295,6 +302,27 @@ gr workflows list -w $WORKSPACE -o json | jq '.[] | {name, task_count: (.tasks |
 gr operator-groups list -w $WORKSPACE -o json | jq '.[].name'
 ```
 
+### Concierge setup over your phone (PSTN / SMS)
+
+Outbound concierge modes ring or text **your verified account phone only** — no destination argument. Verify once, then initiate:
+
+```sh
+# One-time: OTP SMS + TCPA notice (writes Account.phone + phone_verified_at)
+gr account verify-phone --allow-write
+# Optional: pass E.164 inline instead of the prompt
+gr account verify-phone --phone +15551234567 --allow-write
+
+# Server originates call; CLI exits when Twilio returns callSid
+gr concierge chat --call --allow-write
+
+# Server sends opening SMS; CLI exits when messageSid is returned
+gr concierge chat --sms --allow-write
+```
+
+`--call` and `--sms` are mutually exclusive. They cannot be combined with `--voice` or `--realtime` on the same `gr concierge chat` invocation. (`gr concierge --call` / `--sms` are equivalent shorthand.)
+
+If the API returns **412** `account_phone_unverified`, run `gr account verify-phone` first.
+
 ## Related
 
 - [`@gravity-rail/sdk`](https://www.npmjs.com/package/@gravity-rail/sdk) — TypeScript SDK for programmatic access (500+ methods, full type safety)

package/dist/account-verify-phone-4LRJZT5I.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import { requireAuth, startAccountPhoneVerify, confirmAccountPhoneVerify } from './chunk-3EO4COHB.js';
+import './chunk-XRBVAFCB.js';
+import * as readline from 'readline/promises';
+import { stdout, stdin } from 'process';
+
+var TCPA_NOTICE = "By verifying you agree to receive calls and SMS from Gravity Rail at this number.";
+async function accountVerifyPhoneCommand(hctx) {
+  const ctx = requireAuth(hctx.ctx);
+  const phoneArg = typeof hctx.args.phone === "string" ? hctx.args.phone : void 0;
+  process.stderr.write(`${TCPA_NOTICE}
+`);
+  const phone = phoneArg ?? await promptLine("Phone number (E.164, e.g. +15551234567): ");
+  if (!phone.trim()) {
+    throw new Error("Phone number is required");
+  }
+  await startAccountPhoneVerify(ctx, phone.trim());
+  process.stderr.write("Verification code sent via SMS.\n");
+  const code = await promptLine("Enter 6-digit code: ");
+  await confirmAccountPhoneVerify(ctx, code.trim());
+  process.stderr.write(
+    "Phone verified. You can use `gr concierge chat --call` or `gr concierge chat --sms`.\n"
+  );
+}
+async function promptLine(question) {
+  const rl = readline.createInterface({ input: stdin, output: stdout });
+  try {
+    return await rl.question(question) ?? "";
+  } finally {
+    rl.close();
+  }
+}
+
+export { accountVerifyPhoneCommand };
+//# sourceMappingURL=account-verify-phone-4LRJZT5I.js.map
+//# sourceMappingURL=account-verify-phone-4LRJZT5I.js.map

package/dist/account-verify-phone-4LRJZT5I.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/account-verify-phone.ts"],"names":["input","output"],"mappings":";;;;;;AAUA,IAAM,WAAA,GACH,mFAAA;AAEH,eAAsB,0BAA0B,IAAA,EAA4C;AACzF,EAAA,MAAM,GAAA,GAAM,WAAA,CAAY,IAAA,CAAK,GAAG,CAAA;AAChC,EAAA,MAAM,QAAA,GAAW,OAAO,IAAA,CAAK,IAAA,CAAK,UAAU,QAAA,GAAW,IAAA,CAAK,KAAK,KAAA,GAAQ,MAAA;AAEzE,EAAA,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,CAAA,EAAG,WAAW;AAAA,CAAI,CAAA;AAEvC,EAAA,MAAM,KAAA,GAAQ,QAAA,IAAa,MAAM,UAAA,CAAW,2CAA2C,CAAA;AACvF,EAAA,IAAI,CAAC,KAAA,CAAM,IAAA,EAAK,EAAG;AAChB,IAAA,MAAM,IAAI,MAAM,0BAA0B,CAAA;AAAA,EAC7C;AAEA,EAAA,MAAM,uBAAA,CAAwB,GAAA,EAAK,KAAA,CAAM,IAAA,EAAM,CAAA;AAC/C,EAAA,OAAA,CAAQ,MAAA,CAAO,MAAM,mCAAmC,CAAA;AAExD,EAAA,MAAM,IAAA,GAAO,MAAM,UAAA,CAAW,sBAAsB,CAAA;AACpD,EAAA,MAAM,yBAAA,CAA0B,GAAA,EAAK,IAAA,CAAK,IAAA,EAAM,CAAA;AAChD,EAAA,OAAA,CAAQ,MAAA,CAAO,KAAA;AAAA,IACZ;AAAA,GACH;AACH;AAEA,eAAe,WAAW,QAAA,EAAmC;AAC1D,EAAA,MAAM,EAAA,GAAc,QAAA,CAAA,eAAA,CAAgB,SAAEA,KAAA,UAAOC,QAAQ,CAAA;AACrD,EAAA,IAAI;AACD,IAAA,OAAQ,MAAM,EAAA,CAAG,QAAA,CAAS,QAAQ,CAAA,IAAM,EAAA;AAAA,EAC3C,CAAA,SAAE;AACC,IAAA,EAAA,CAAG,KAAA,EAAM;AAAA,EACZ;AACH","file":"account-verify-phone-4LRJZT5I.js","sourcesContent":["/**\n * `gr account verify-phone` — verify account phone for concierge PSTN/SMS.\n */\n\nimport * as readline from 'node:readline/promises';\nimport { stdin as input, stdout as output } from 'node:process';\nimport { confirmAccountPhoneVerify, startAccountPhoneVerify } from '../lib/concierge-api';\nimport { requireAuth } from '../lib/context';\nimport type { CommandHandlerContext } from '../lib/types';\n\nconst TCPA_NOTICE =\n   'By verifying you agree to receive calls and SMS from Gravity Rail at this number.';\n\nexport async function accountVerifyPhoneCommand(hctx: CommandHandlerContext): Promise<void> {\n   const ctx = requireAuth(hctx.ctx);\n   const phoneArg = typeof hctx.args.phone === 'string' ? hctx.args.phone : undefined;\n\n   process.stderr.write(`${TCPA_NOTICE}\\n`);\n\n   const phone = phoneArg ?? (await promptLine('Phone number (E.164, e.g. +15551234567): '));\n   if (!phone.trim()) {\n      throw new Error('Phone number is required');\n   }\n\n   await startAccountPhoneVerify(ctx, phone.trim());\n   process.stderr.write('Verification code sent via SMS.\\n');\n\n   const code = await promptLine('Enter 6-digit code: ');\n   await confirmAccountPhoneVerify(ctx, code.trim());\n   process.stderr.write(\n      'Phone verified. You can use `gr concierge chat --call` or `gr concierge chat --sms`.\\n'\n   );\n}\n\nasync function promptLine(question: string): Promise<string> {\n   const rl = readline.createInterface({ input, output });\n   try {\n      return (await rl.question(question)) ?? '';\n   } finally {\n      rl.close();\n   }\n}\n"]}