frontpage-host 0.3.6 → 0.3.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/AGENTS.md CHANGED
@@ -262,7 +262,7 @@ Use `frontpage people overview`, `groups`, `stages`, `membership`, `rules`, `att
262
262
 
263
263
  Manual group selection uses `groups.people` (20 per page, phone-only contacts included, no email-permission filter) and `membership.addMany` (1 to 20 IDs, real per-person outcomes, safe retries). Use these through `frontpage people workspace OPERATION --file payload.json`; existing CLI versions support that route. Conditional groups use the read-only `groups.preview`, with `checked`, `unknown`, cursor/limit and optional `expectedConditions` to detect changes between pages. Do not turn a conditional preview into additions or exceptions. See PEOPLE.md for mode changes, partial results and bounds.
264
264
 
265
- ## Customer Inbox
265
+ ## AI Support Agent
266
266
 
267
267
  Scale and internal sites, after owner activation. No pilot allowlist. Use `frontpage customer-inbox get|put|post RESOURCE`, stable write keys and current versions. Full guide: [CUSTOMER-INBOX.md](./CUSTOMER-INBOX.md). `export CONVERSATION_ID --out FILE` writes authorized paginated history and file metadata; `download FILE_ID --out FILE` downloads through a file grant. Outputs never overwrite existing files. `frontpage usage` reports shared site credits, mail and storage. The owner toolbar uses `manage_customer_inbox` for all site-wide Inbox settings, unlocked knowledge, files, customer conversations, private guidance, replies, takeover/return and recovery. The support agent has a separate server-bound customer scope and requires verification for People data. Both agents cannot edit or unlock locked knowledge; human UI/CLI can unlock it. Never lend a website agent a human CLI key.
268
268
 
@@ -274,9 +274,9 @@ Offerings own every standalone Pay now payment. Use `frontpage payments buttons
274
274
 
275
275
  Currency is owned by Payments and read by Store, Offerings and invoices. Offering create/get/update responses include exact receiptVariables. For custom confirmations, declare those names with existing mail template commands, attach receiptTemplateId, and verify both records. Only include expressly selected answers; keep private answers excluded. Forms still use input-name tokens and confirmTemplateId.
276
276
 
277
- Customer Inbox setup: enable website chat through Inbox settings; Frontpage public sites load it without a file edit or publish. Other websites use the explicit widget snippet. `get website` reports managed addresses/public availability. Website knowledge is default-on, read-only public retrieval; `websiteKnowledge.enabled:false` disables it. Source toggles, attention filtering and receipt cursors use the documented versioned resources.
277
+ AI Support Agent setup: enable website chat through Inbox settings; Frontpage public sites load it without a file edit or publish. Other websites use the explicit widget snippet. `get website` reports managed addresses/public availability. Website knowledge is default-on, read-only public retrieval; `websiteKnowledge.enabled:false` disables it. Source toggles, attention filtering and receipt cursors use the documented versioned resources.
278
278
 
279
- Customer Inbox team guidance: administrators may set `guidanceEmail` through the versioned settings write. The owner toolbar has the same setting. Teammates reply as the configured mailbox; no teammate account or separate mailbox activation is needed. Do not set it to the public Inbox address. Conversation management uses close/reopen; do not use read/trash/restore.
279
+ AI Support Agent team guidance: administrators may set `guidanceEmail` through the versioned settings write. The owner toolbar has the same setting. Teammates reply as the configured mailbox; no teammate account or separate mailbox activation is needed. Do not set it to the public Inbox address. Conversation management uses close/reopen; do not use read/trash/restore.
280
280
 
281
281
  ## Emails workspace workflows
282
282
 
package/CUSTOMER-INBOX.md CHANGED
@@ -1,6 +1,8 @@
1
- # Customer Inbox
1
+ # AI Support Agent
2
2
 
3
- Customer Inbox uses the site's existing AI credits and storage allowance. It is available on Scale and internal plans after owner activation. Other public plans do not include Inbox. No pilot allowlist is required. The support agent uses fixed GPT-6 Luna and bills AI usage at 10× raw provider cost. During human handling, customer messages use ordinary routing. Normal owner-control email uses a small metered Luna Decisions call to keep private guidance, ownership controls and customer-facing replies distinct; the full support agent stays paused. UI and CLI controls need no intent call.
3
+ The product name is AI Support Agent. The existing `frontpage customer-inbox` command, `/customer-inbox` routes and `manage_customer_inbox` tool identifiers stay unchanged.
4
+
5
+ AI Support Agent uses the site's existing AI credits and storage allowance. It is available on Scale and internal plans after owner activation. Other public plans do not include Inbox. No pilot allowlist is required. The support agent uses fixed GPT-6 Luna and bills AI usage at 10× raw provider cost. During human handling, customer messages use ordinary routing. Normal owner-control email uses a small metered Luna Decisions call to keep private guidance, ownership controls and customer-facing replies distinct; the full support agent stays paused. UI and CLI controls need no intent call.
4
6
 
5
7
  Run `frontpage help customer-inbox`. Use the site's normal CLI key:
6
8
 
package/README.md CHANGED
@@ -110,3 +110,7 @@ Read `items get` first. Include `expectedStock` only when changing stock; copy t
110
110
  To turn versions on in the same edit, send `optionNames` and `firstVariant` using the normal variant fields. Do not combine `firstVariant` with `variantUpdates`. To turn versions off, send `optionNames:[]`; optional changes then address the `default` variant. Existing stock and variant commands remain available for explicit individual operations. IDs, order history, site/role/plan gates, and provider ownership stay unchanged. Browser forms use the same service. A successful save returns the saved product; a later list refresh cannot undo it.
111
111
 
112
112
  An explicit stock target already equal to the current count is a no-op. Repeating that same target after a lost response does not fail merely because the earlier save applied it. A different current count still requires review; never automatically replace expectedStock.
113
+
114
+ ### AI Support Agent
115
+
116
+ Included on Scale and internal sites after owner activation. Use `frontpage customer-inbox` for settings, knowledge and customer conversations. The command and API paths keep their existing names. See [AI Support Agent](./CUSTOMER-INBOX.md) for permissions, private guidance, takeover, verification and shared usage.
@@ -112,7 +112,7 @@ export async function runCustomerInbox(args) {
112
112
  else {
113
113
  const bytes = await readFile(operation.file);
114
114
  if (bytes.length > 65536)
115
- throw new CliHttpError("Inbox JSON exceeds 64 KiB.", EXIT_USAGE, 413, "payload_too_large");
115
+ throw new CliHttpError("AI Support Agent JSON exceeds 64 KiB.", EXIT_USAGE, 413, "payload_too_large");
116
116
  let value;
117
117
  try {
118
118
  value = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(bytes));
@@ -151,7 +151,7 @@ export async function runCustomerInbox(args) {
151
151
  if (isJson())
152
152
  emitErr("customer-inbox", e);
153
153
  else
154
- console.error(e instanceof Error ? e.message : "Inbox request failed.");
154
+ console.error(e instanceof Error ? e.message : "AI Support Agent request failed.");
155
155
  return exitCodeForError(e);
156
156
  }
157
157
  }
package/dist/registry.js CHANGED
@@ -417,7 +417,7 @@ export const COMMANDS = [
417
417
  },
418
418
  {
419
419
  name: "customer-inbox",
420
- summary: "Manage internal Customer Inbox settings, knowledge and human conversation handling",
420
+ summary: "Manage AI Support Agent settings, knowledge and customer conversations",
421
421
  usage: "frontpage customer-inbox get|put|post <resource> [--file <json>] [--request-key <key>] [--site <slug>] [--json]; export|download <id> --out <new-file>",
422
422
  topics: ["content"],
423
423
  examples: [
@@ -427,9 +427,9 @@ export const COMMANDS = [
427
427
  "frontpage customer-inbox get knowledge",
428
428
  ],
429
429
  flags: [
430
- "Internal plans and the site pilot apply",
430
+ "Available on Scale and internal sites after owner activation; no pilot allowlist",
431
431
  "Writes require a stable --request-key and a JSON file; reuse both on retries",
432
- "Human CLI access can guide, take over and reply; website-agent tools have management scope only",
432
+ "Human CLI and owner-agent tools manage authorized conversations; customer support tools stay bound to the verified customer",
433
433
  "Luna and 10× AI billing are fixed",
434
434
  "Full request examples: CUSTOMER-INBOX.md",
435
435
  ],
package/llms.txt CHANGED
@@ -38,7 +38,7 @@ New owner-added and CSV-imported contacts default to allowed for marketing. Expl
38
38
 
39
39
  Use `frontpage people overview`, `groups`, `stages`, `membership`, `rules`, `attachments`, `import`. Use `frontpage mail campaign` for one-off group/stage/list audiences in Emails. Every editor action is available through these commands or `frontpage people workspace OPERATION --file payload.json`. Full operations and examples: [PEOPLE.md](./PEOPLE.md); public guide: https://frontpage.host/developers/people. Automated emails select a saved template or series. Campaigns use their own drafts.
40
40
 
41
- Customer Inbox (Scale and internal sites): CUSTOMER-INBOX.md. Settings, widget, knowledge, human guidance/relay, lifecycle, export/download and recovery. The owner toolbar manages all site-wide Inbox operations through manage_customer_inbox, including conversations, files and recovery, but cannot edit/unlock locked knowledge. The support agent is restricted to its verified customer and cannot change shared knowledge from customer input. No borrowed human credentials.
41
+ AI Support Agent (Scale and internal sites): CUSTOMER-INBOX.md. Settings, widget, knowledge, human guidance/relay, lifecycle, export/download and recovery. The owner toolbar manages all site-wide Inbox operations through manage_customer_inbox, including conversations, files and recovery, but cannot edit/unlock locked knowledge. The support agent is restricted to its verified customer and cannot change shared knowledge from customer input. No borrowed human credentials.
42
42
 
43
43
 
44
44
  Payments, invoices and recurring billing: see packaged [PAYMENTS.md](./PAYMENTS.md), `frontpage help payments`, and https://frontpage.host/developers/payments. Version 0.2.0 removes writable currency, Store checkout mode and Store-owned money commands; Store stays cart-only. Preview/review before sends; keep stable operation keys on retries. Autopay requires the customer’s own verified authorization.
@@ -48,7 +48,7 @@ Offerings own every standalone Pay now payment. Use `frontpage payments buttons
48
48
 
49
49
  Payments owns Stripe currency. Read Offering receiptVariables before creating a confirmation template; attach it through Payments. Forms use submitted input names. Full receipt contract: PAYMENTS.md.
50
50
 
51
- Customer Inbox: Frontpage website chat uses one settings toggle, no website edit/publish. get website shows public availability/managed addresses. websiteKnowledge.enabled controls default-on support website reads; no source or private-preview access. Source-ID toggles, attention filtering and held receipt pagination are supported. See CUSTOMER-INBOX.md.
51
+ AI Support Agent: Frontpage website chat uses one settings toggle, no website edit/publish. get website shows public availability/managed addresses. websiteKnowledge.enabled controls default-on support website reads; no source or private-preview access. Source-ID toggles, attention filtering and held receipt pagination are supported. See CUSTOMER-INBOX.md.
52
52
 
53
53
  ## Emails workspace workflows
54
54
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "frontpage-host",
3
- "version": "0.3.6",
3
+ "version": "0.3.7",
4
4
  "description": "Frontpage CLI \u2014 manage your site from the terminal",
5
5
  "type": "module",
6
6
  "bin": {