frontpage-host 0.3.8 → 0.3.9

package/CUSTOMER-INBOX.md

@@ -198,7 +198,16 @@ Read the current settings version, then save this JSON as `website-settings.json
 frontpage customer-inbox put settings --site my-site --file website-settings.json --request-key website_search_off_001
 ```
 
-The support agent can call `website_search({query,cursor?})` and `website_read({path,cursor?})`. Both are bound to the active job's own public business website. They accept no other site ID, hostname, source path or credential. Searches reuse the existing text matcher and fetch at most four public pages per call. Results include matching URLs/excerpts, `scanned`, `discovered`, `unavailable`, `partial` and `nextCursor`.
+The support agent can call `website_search({query,cursor?})` and `website_read({path,cursor?})`. Both are bound to the active job's own public business website. They accept no other site ID, hostname, source path or credential. Searches match focused keywords and fetch at most four public pages per call. Results include matching URLs/excerpts, `scanned`, `discovered`, `unavailable`, `partial` and `nextCursor`.
+
+Use a focused query such as `repair pricing`. Follow a search `nextCursor` with the **same query**; start a changed query without a cursor. Read a promising result with `website_read({path:"/services"})`, using the returned site-relative path. Reads return up to 8,000 characters with `truncated` and `nextCursor`; continue with the **same path** to read more text. A changed page or expired cursor requires restarting without the cursor. Search previews are not complete evidence. An empty partial batch does not prove that the answer is absent.
+
+Expected tool failures return `error`, `message`, `nextAction` and `retryable`. `website_cursor_invalid` explains how to restart the request. Page failures identify whether another result or a bounded retry is useful. `retryable` refers to a transient failure, not permission to repeat invalid input. The agent corrects recoverable inputs before escalating; revoked permissions and stale jobs still stop execution. No source files, private pages, credentials or external-site override become available.
+
+`knowledge_read({query})` searches saved notes and enabled approved sources by keywords. Previews include matching passages and `hasMore:{notes,sources}`. When either flag is true, refine the subject to find the relevant item; do not treat the preview list as complete. Use `knowledge_read({id})` for a complete note or `knowledge_read({sourceId})` for a complete enabled source. Support source searches filter before bounding results, and direct source reads do not depend on the management list's page. Existing approval, freshness, locks and learning rules remain in force.
+
+The widget shows sending/upload feedback and animated dots while an automatic response is queued or running. The existing chat session response adds `activity` with `processing`, `awaiting_team`, `paused` or `idle`; it exposes no private job details. Awaiting owner guidance replaces the dots with a team-wait message; paused work does not keep typing. These are customer-safe statuses, not private tool results. Private guidance requests include customer-visible conversation history, with a full Inbox link and a labeled recent excerpt for oversized threads. Reply privately with new guidance; quoted history is context, not new instructions. Recipients, takeover controls, verification and email delivery rules are unchanged.
+
 
 Example search result for `{"query":"repairs"}`:
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "frontpage-host",
-  "version": "0.3.8",
-  "description": "Frontpage CLI \u2014 manage your site from the terminal",
+  "version": "0.3.9",
+  "description": "Frontpage CLI — manage your site from the terminal",
   "type": "module",
   "bin": {
     "frontpage": "dist/bin.js"