@maxceem/agw 0.11.2 → 0.12.0

package/dist/agw.mjs

@@ -6,7 +6,7 @@ var __export = (target, all) => {
 };
 
 // <define:__AGW_MANIFEST__>
-var define_AGW_MANIFEST_default = { version: "0.11.2", wrangler: "4.96.0", upgradeFrom: ["0.11.2", "0.11.1", "0.11.0", "0.10.11", "0.10.10", "0.10.9", "0.10.8", "0.10.7", "0.10.6", "0.10.5", "0.10.4", "0.10.3", "0.10.2", "0.10.1", "0.10.0", "0.9.3", "0.9.2", "0.9.1", "0.9.0", "0.8.3", "0.8.2", "0.8.1", "0.8.0", "0.7.2", "0.7.1", "0.7.0", "0.6.4", "0.6.3", "0.6.2", "0.6.1", "0.6.0", "0.5.2", "0.5.1", "0.5.0", "0.4.0"], release: { url: "https://github.com/maxceem/app-ai-gateway/releases/download/v0.11.2/gateway-0.11.2.tar.gz", sha256: "735cb199e13b5ae6b3ab97d5d5ebda0fa37db4508fd9ba66a346ebd0113f3ac3", manifest: "bbf263b99700b66f07b5a1ed62c0b55566ee484de8c15ae9d2660452a97e20d7" } };
+var define_AGW_MANIFEST_default = { version: "0.12.0", wrangler: "4.96.0", upgradeFrom: ["0.12.0", "0.11.2", "0.11.1", "0.11.0", "0.10.11", "0.10.10", "0.10.9", "0.10.8", "0.10.7", "0.10.6", "0.10.5", "0.10.4", "0.10.3", "0.10.2", "0.10.1", "0.10.0", "0.9.3", "0.9.2", "0.9.1", "0.9.0", "0.8.3", "0.8.2", "0.8.1", "0.8.0", "0.7.2", "0.7.1", "0.7.0", "0.6.4", "0.6.3", "0.6.2", "0.6.1", "0.6.0", "0.5.2", "0.5.1", "0.5.0", "0.4.0"], release: { url: "https://github.com/maxceem/app-ai-gateway/releases/download/v0.12.0/gateway-0.12.0.tar.gz", sha256: "6865dcab2a4a1043812c31f284321b260b2e0ca64a2a0ad01658f8c850a10300", manifest: "47347e6b473211c44aa35c609877d23cad7f59b5ad9967d354e97a0f6d230c68" } };
 
 // src/main.ts
 import { Writable as Writable2 } from "node:stream";
@@ -15886,6 +15886,30 @@ var ConfirmEmailVerificationRequestSchema = external_exports.object({
     description: "The `token` query parameter of the link in the verification email."
   })
 }).strict();
+var SupportMessageKindSchema = external_exports.enum(["bug", "support", "feedback"]);
+var SUPPORT_TOPICS = {
+  bug: "Bug report",
+  support: "Support request",
+  feedback: "Feedback"
+};
+var SUPPORT_CONTEXT_KEY = /^[A-Za-z][A-Za-z0-9_.-]{0,39}$/;
+var SupportMessageRequestSchema = external_exports.object({
+  kind: SupportMessageKindSchema,
+  message: external_exports.string().trim().min(1, "Write a message").max(1e4).meta({
+    description: "What the person wants support to know, in their words. Never include a key, token or password."
+  }),
+  /** The console page the message was written from, for context. */
+  page: ConsoleReturnPathSchema.optional(),
+  context: external_exports.record(
+    external_exports.string().regex(SUPPORT_CONTEXT_KEY, "Context names are letters, digits, _ . and -, up to 40 characters"),
+    external_exports.string().trim().min(1).max(500)
+  ).refine((value) => Object.keys(value).length <= 20, "At most 20 context entries").optional().meta({
+    description: "Facts that help support act without asking back, such as app_id, request_id, error_code or agw_version. Never a credential."
+  }),
+  client: external_exports.string().trim().min(1).max(100).optional().meta({
+    description: "What sent the message, such as `agw 0.10.3`, as the client reports it. A label only."
+  })
+}).strict();
 
 // src/common.ts
 import { randomBytes } from "node:crypto";
@@ -16120,7 +16144,8 @@ var commands = {
   "usage show": { args: 0, flags: "app month" },
   "usage breakdown": { args: 0, flags: "app by from to limit" },
   "operation status": { args: 1, flags: "" },
-  "operation wait": { args: 1, flags: "timeout" }
+  "operation wait": { args: 1, flags: "timeout" },
+  "support send": { args: 0, flags: "type message message-stdin! context* yes!" }
 };
 function flagList(value) {
   if (value === void 0) return [];
@@ -16201,6 +16226,7 @@ function parse3(argv) {
     ["pricing", "clear-pricing"],
     ["route", "clear-route"],
     ["provider", "all-providers"],
+    ["message", "message-stdin"],
     ...command === "app snippet" ? [["provider", "endpoint"]] : []
   ]) {
     if (group.filter((k) => collected[k] !== void 0).length > 1)
@@ -16241,6 +16267,7 @@ Login: account login and deployment connect open the browser; check that it show
 Credentials: ${MANAGEMENT_KEY_ENV}, when set, is the management key for every command and overrides the saved login. account logout revokes the saved key.
 Secrets: hidden prompt by default; --key-stdin reads one line. Provider --browser submits credentials directly to your gateway.
 Browser operations: --json or --no-input returns pending; operation wait resumes.
+Support: support send emails human support for the signed-in person, who gets the reply by email. Without a terminal it needs --yes: show the person the message first. Never put a key or token in it.
 No account is created by help, status, list, validation or dry runs.
 `;
 }
@@ -17575,7 +17602,13 @@ var ConsoleCapabilitiesResponseSchema = external_exports.object({
    * account's apps serve requests only once its owner has verified theirs, and
    * the console offers the link to do it.
    */
-  emailVerification: external_exports.boolean()
+  emailVerification: external_exports.boolean(),
+  /**
+   * The inbox the Support menu writes to, present only where the deployment
+   * has billing and can send email. The console still offers the menu only to
+   * an organization on a paid plan, and the gateway refuses anyone else.
+   */
+  supportEmail: external_exports.email().optional()
 });
 var GoogleSignInResponseSchema = external_exports.object({
   url: external_exports.url().meta({ description: "Provider authorization URL for the browser to navigate to." }),
@@ -18069,6 +18102,16 @@ var ConfirmEmailVerificationResponseSchema = external_exports.object({
     description: "The console path the link was asked for from, to continue there; null for none."
   })
 });
+var SupportMessageResponseSchema = external_exports.object({
+  status: external_exports.literal("sent"),
+  reference: external_exports.string().meta({
+    description: "The request's reference, such as SUP-7F3K2Q, in the email's subject too. Quote it when following up."
+  }),
+  replyTo: external_exports.string().meta({ description: "The address support will reply to: the sender's own." }),
+  duplicate: external_exports.boolean().meta({
+    description: "True when the same message was sent in the last ten minutes: nothing new was sent, and reference is the earlier one's."
+  })
+});
 var OrganizationListResponseSchema = external_exports.object({
   organizations: external_exports.array(OrganizationMembershipSchema)
 });
@@ -18977,6 +19020,38 @@ var CATALOG = {
     response: BillingAccessSchema,
     responseDescription: "Trial access state."
   },
+  /*
+   * Support is part of a paid plan, so it sits with billing: it is offered
+   * only to an organization on one, and refused to everyone else. A person in
+   * the console, the CLI and an MCP client all send through this one entry, so
+   * the plan check, the secret check and the limits are the same for each.
+   *
+   * Any role may write, read-only members included: a message changes nothing
+   * in the account. The grant is the default `manage` all the same, because it
+   * emails a person, and a `read` credential changes nothing outside the
+   * gateway either.
+   */
+  sendSupportMessage: {
+    method: "POST",
+    path: "/v1/admin/support",
+    hidden: true,
+    tags: ["Admin billing"],
+    summary: "Send a message to support",
+    description: "Opens a support ticket for the person the credential belongs to: they get an email with its reference and their message, copied to the deployment's support inbox, and support answers them by replying to it. Send only what the person asked to send, and never a credential: a message or context value that looks like a key, token or password is refused. The same message sent again within ten minutes is not sent twice; the answer says so and repeats the reference.",
+    security: "management",
+    policy: { role: "member", access: "read" },
+    request: SupportMessageRequestSchema,
+    response: SupportMessageResponseSchema,
+    responseDescription: "The ticket was opened; support replies to the sender's email address.",
+    errors: {
+      400: "The body is malformed, or carries something that looks like a credential (`invalid_request`).",
+      403: "The account's plan does not include human support (`support_plan_required`), or the credential has the read grant (`grant_insufficient`).",
+      404: "This deployment does not offer human support (`not_found`).",
+      409: "The credential's owner has no email address to reply to (`conflict`).",
+      429: "Too many messages were sent by this person. Carries Retry-After.",
+      503: "The help desk could not be reached; try again later (`email_unavailable`)."
+    }
+  },
   getApp: {
     method: "GET",
     path: "/v1/admin/apps/{app}",
@@ -21935,8 +22010,19 @@ function render(command, result, context, style2) {
     case "deployment update":
     case "deployment domain":
       return deployment(result, style2);
+    case "support send":
+      return support(result, style2);
   }
 }
+function support(result, style2) {
+  if (!("reference" in result)) return [];
+  return [
+    style2.headline(
+      result.duplicate ? `Already sent as ${result.reference} in the last ten minutes; nothing new was sent.` : `Sent to human support as ${result.reference}.`
+    ),
+    ...kv([["Replies go to", result.replyTo]], style2)
+  ];
+}
 function status(command, result, context, style2) {
   const did = command === "account login" ? [style2.headline(`Signed in to ${context.url}.`)] : command === "deployment connect" ? [style2.headline(`Connected to ${context.url}.`)] : [];
   if ("billing" in result)
@@ -22364,6 +22450,73 @@ function deployment(result, style2) {
   return [style2.json(result)];
 }
 
+// src/support.ts
+import { stderr as stderr2, stdin as stdin2 } from "node:process";
+var MAX_MESSAGE = 1e4;
+async function supportCommand(ctx, flags) {
+  const kind = supportKind(flags.type ?? await prompt("Type (bug, support or feedback)", flags));
+  if (flags.message !== void 0 && flags["message-stdin"])
+    fail("conflicting_flags", "--message and --message-stdin conflict.");
+  const message = (flags["message-stdin"] ? await readMessage() : flags.message ?? await prompt("Message", flags)).trim();
+  if (!message) fail("invalid_input", "Supply a nonempty message.");
+  if (message.length > MAX_MESSAGE)
+    fail("invalid_input", `The message is longer than ${MAX_MESSAGE} characters.`);
+  const context = supportContext(flagList(flags.context));
+  if (!flags.yes) {
+    if (flags["no-input"] || !stdin2.isTTY || !stderr2.isTTY)
+      fail(
+        "confirmation_required",
+        "Sending to human support needs confirmation.",
+        "Show the person the exact message, and once they agree run the same command with --yes."
+      );
+    stderr2.write(preview(kind, message, context));
+    await confirm("Send this to human support?", flags);
+  }
+  return (await ctx.call("sendSupportMessage", {
+    body: {
+      kind,
+      message,
+      ...Object.keys(context).length ? { context } : {},
+      client: `agw ${VERSION}`
+    }
+  })).data;
+}
+function supportKind(value) {
+  const parsed = SupportMessageKindSchema.safeParse(value.trim().toLowerCase());
+  if (!parsed.success) fail("invalid_input", "--type must be bug, support or feedback.");
+  return parsed.data;
+}
+function supportContext(entries) {
+  const context = {};
+  for (const entry of entries) {
+    const at = entry.indexOf("=");
+    if (at < 1 || at === entry.length - 1)
+      fail("invalid_input", "--context takes name=value, such as --context app_id=my-app.");
+    context[entry.slice(0, at).trim()] = entry.slice(at + 1).trim();
+  }
+  return context;
+}
+async function readMessage() {
+  const chunks = [];
+  let size = 0;
+  for await (const chunk of stdin2) {
+    size += chunk.length;
+    if (size > MAX_MESSAGE * 4) fail("invalid_input", `The message is longer than ${MAX_MESSAGE} characters.`);
+    chunks.push(chunk);
+  }
+  return Buffer.concat(chunks).toString();
+}
+function preview(kind, message, context) {
+  const lines = [
+    `To: human support (${SUPPORT_TOPICS[kind]})`,
+    ...Object.entries(context).map(([name, value]) => `${name}: ${value}`),
+    "",
+    message,
+    ""
+  ];
+  return lines.join("\n") + "\n";
+}
+
 // src/transport.ts
 var MESSAGE_LIMIT = 300;
 function* strings(value) {
@@ -22392,6 +22545,8 @@ function nextActionFor(status2, code, details) {
   if (status2 === 401) return "Run agw account login.";
   if (code === "billing_plan_limit_reached")
     return "Delete one you no longer need, or move to a plan whose limits are higher.";
+  if (code === "support_plan_required")
+    return "Tell the person human support is included with paid plans; an account owner can choose one on the console's Billing page.";
   if (status2 === 429) {
     const seconds = details.retryAfterSeconds;
     if (seconds === void 0)
@@ -22541,6 +22696,7 @@ async function execute(parsed, ctx) {
     return resourceCommand(ctx, command, args, flags);
   if (command.startsWith("app ")) return appCommand(ctx, command, args, flags);
   if (command.startsWith("usage ")) return usageCommand(ctx, command, flags);
+  if (command === "support send") return supportCommand(ctx, flags);
   if (command.startsWith("operation "))
     return command === "operation wait" ? ctx.wait(args[0] ?? "", positive(flags.timeout ?? 300)) : ctx.poll(args[0] ?? "");
   if (command === "account status") return (await ctx.call("getCliAccount")).data;
@@ -22571,7 +22727,7 @@ async function main(argv = process.argv.slice(2), {
   store = new StateStore(),
   transport = new Transport(),
   stdout = process.stdout,
-  stderr: stderr2 = process.stderr,
+  stderr: stderr3 = process.stderr,
   io = {}
 } = {}) {
   const json2 = argv.includes("--json");
@@ -22586,8 +22742,8 @@ async function main(argv = process.argv.slice(2), {
       return 0;
     }
     const run = async () => {
-      const state = await store.read((line) => stderr2.write(line + "\n"));
-      const ctx = new Context(store, state, transport, parsed.flags, { ...io, stderr: stderr2 });
+      const state = await store.read((line) => stderr3.write(line + "\n"));
+      const ctx = new Context(store, state, transport, parsed.flags, { ...io, stderr: stderr3 });
       const result = await execute(parsed, ctx);
       const context = {
         url: ctx.url,
@@ -22631,7 +22787,7 @@ async function main(argv = process.argv.slice(2), {
       );
       return e.exitCode;
     }
-    const style2 = styleFor(stderr2);
+    const style2 = styleFor(stderr3);
     const lines = [
       style2.alert(`Error: ${e.message}`),
       style2.warn(`Next: ${e.nextAction}`),
@@ -22639,7 +22795,7 @@ async function main(argv = process.argv.slice(2), {
     ];
     for (const [key, value] of Object.entries(reported2.details ?? {}))
       lines.push(`  ${style2.dim(`${key}:`)} ${String(value)}`);
-    stderr2.write(lines.join("\n") + "\n");
+    stderr3.write(lines.join("\n") + "\n");
     return e.exitCode;
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maxceem/agw",
-  "version": "0.11.2",
+  "version": "0.12.0",
   "type": "module",
   "description": "Manage App AI Gateway from a terminal or coding agent: providers, iOS and server apps, usage, and self-hosted deployment on Cloudflare",
   "keywords": [
@@ -26,6 +26,7 @@
   },
   "bugs": "https://github.com/maxceem/app-ai-gateway/issues",
   "upgradeFrom": [
+    "0.11.2",
     "0.11.1",
     "0.11.0",
     "0.10.11",