From c0f6b404ca9a60d1713a50ea3c0b4d7de1a01c02 Mon Sep 17 00:00:00 2001
From: Yevhen Porechnyi <yevhen.porechnyi@corezoid.com>
Date: Thu, 3 Sep 2026 16:59:05 +0300
Subject: [PATCH 1/2] docs(smart-forms): document the page-level browser tab
 title
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

A CDU page config may now carry a root-level `title`, and `appGetPage` returns
it alongside the rest of the Page. Without this the agent has no way to know
the field exists: it would neither read it from a rendered page nor write it
when authoring one.

- `appGetPage` advertised the Page as `{ grid, forms[], notifications[], query,
  language }`; `title` joins that list.
- The page protocol doc gains the field in the GET response shape and in the
  page model tree.
- The smart-forms skill had no section for the root of a page `config` at all —
  it went straight from the minimal example to `Grid`. Adds a compact one, with
  `title` explained: omit it and the host names the tab `<page> - <script ref>`,
  or the script ref alone on `index`; a form embedded into another screen never
  renames the browser tab either way.

Backend side: pong-server resolves `[[locale]]` and `{{viewModel}}` inside the
title, so it can be localised or built at runtime.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
---
 .../docs/user-flows/cdu-page-protocol.md      |  2 ++
 .../mcp-server/internal/tools/smartforms.go   |  2 +-
 .../skills/simulator-smart-forms/SKILL.md     | 19 +++++++++++++++++++
 3 files changed, 22 insertions(+), 1 deletion(-)

diff --git a/plugins/simulator/docs/user-flows/cdu-page-protocol.md b/plugins/simulator/docs/user-flows/cdu-page-protocol.md
index 01793fc..167aeff 100644
--- a/plugins/simulator/docs/user-flows/cdu-page-protocol.md
+++ b/plugins/simulator/docs/user-flows/cdu-page-protocol.md
@@ -85,6 +85,7 @@ Corezoid with `path: '/get'` or `'/send'` plus `{ page, query, context }` and `s
 {
   "code": 200,
   "data": {
+    "title": "My orders",       // optional; browser tab title of the page
     "grid":  { /* Grid — layout */ },
     "forms": [ /* Form[] — content */ ],
     "query": { /* echoed/updated query */ },
@@ -141,6 +142,7 @@ The render tree is **Page → Grid → Form → Section → Item**:
 
 ```
 Page
+ ├─ title?          browser tab title; falls back to a host-composed name
  ├─ grid            layout: column model, header, sidebar, region→form mapping
  └─ forms[]         one or more Form
        ├─ (grid?)   a form may carry its own nested grid
diff --git a/plugins/simulator/mcp-server/internal/tools/smartforms.go b/plugins/simulator/mcp-server/internal/tools/smartforms.go
index 8db4996..f2b1953 100644
--- a/plugins/simulator/mcp-server/internal/tools/smartforms.go
+++ b/plugins/simulator/mcp-server/internal/tools/smartforms.go
@@ -21,7 +21,7 @@ var smartFormOps = []Operation{
 	{
 		Name: "appGetPage", Method: "GET", Path: "/pages/{accId}/{ref}/{envTitle}/{page}",
 		Summary: "Render one page of a Smart Form (CDU / Script application) — the runtime equivalent of opening " +
-			"the app's page in the UI. Returns a Page `{ grid, forms[], notifications[], query, language }` " +
+			"the app's page in the UI. Returns a Page `{ title, grid, forms[], notifications[], query, language }` " +
 			"(code 200); the env's Corezoid process supplies the dynamic viewModel/data. Read `forms[].sections[].content[]` " +
 			"to see the components (items) to fill, and `notifications[]` for messages from the process. Then submit with " +
 			"appSendForm. Start a flow at page `index`. Smart Forms are addressed by (accId, ref, envTitle); use the " +
diff --git a/plugins/simulator/skills/simulator-smart-forms/SKILL.md b/plugins/simulator/skills/simulator-smart-forms/SKILL.md
index 649feeb..34038ae 100644
--- a/plugins/simulator/skills/simulator-smart-forms/SKILL.md
+++ b/plugins/simulator/skills/simulator-smart-forms/SKILL.md
@@ -209,6 +209,25 @@ The page `config` is the layout template. Structure: **Page → Grid → Form 
 }
 ```
 
+### Page (root of `config`)
+
+```jsonc
+{
+  "title": "My orders",        // browser tab title; see below
+  "grid":  { /* layout */ },
+  "forms": [ /* content */ ],
+  "language": "uk",            // base locale for [[…]] and date formatting
+  "styleClass": "orders-page",
+  "query": { "ref": "{{ref}}" },
+  "notifications": [ /* shown when the page opens */ ]
+}
+```
+
+`title` names the browser tab. Omit it and the tab is named by the host
+application — `<page> - <script ref>`, or the script ref alone on the `index`
+page. A Smart Form embedded into another screen (a modal, a section header)
+never renames the browser tab, whether a title is set or not.
+
 ### Grid
 
 ```jsonc

From bce9303184f8e4e9df58167c66476386daab46fa Mon Sep 17 00:00:00 2001
From: Yevhen Porechnyi <yevhen.porechnyi@corezoid.com>
Date: Thu, 3 Sep 2026 17:32:02 +0300
Subject: [PATCH 2/2] docs(smart-forms): note that page fields accept
 whole-value placeholders
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The Page block added in this branch shows `query` as an object and
`notifications` as an array, which is only half the story: those values are
resolved server-side, so each may instead be a single `{{viewModel}}` or
`[[locale]]` token that arrives as an object or an array. Without saying so the
skill teaches the shape and quietly hides the mechanism.

Also names the positions that are *not* resolved — `grid.type`,
`grid.styleClass`, `grid.sideBar`, `grid.header.class` and the keys inside a
page-level `extra` — since a placeholder written there is left as literal text
with no error to explain it. Both lists come from running `renderPage` against
every position.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
---
 .../skills/simulator-smart-forms/SKILL.md     | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/plugins/simulator/skills/simulator-smart-forms/SKILL.md b/plugins/simulator/skills/simulator-smart-forms/SKILL.md
index 34038ae..b9b6667 100644
--- a/plugins/simulator/skills/simulator-smart-forms/SKILL.md
+++ b/plugins/simulator/skills/simulator-smart-forms/SKILL.md
@@ -228,6 +228,25 @@ application — `<page> - <script ref>`, or the script ref alone on the `index`
 page. A Smart Form embedded into another screen (a modal, a section header)
 never renames the browser tab, whether a title is set or not.
 
+**A whole value may be a placeholder.** `query`, `notifications` and `extra` are
+resolved server-side, so any of them can be written as a single `{{viewModel}}`
+or `[[locale]]` token and arrive as an object or an array:
+
+```jsonc
+"query":         "{{query}}",      // → object
+"notifications": "{{messages}}",   // → array
+"extra":         "{{pageExtra}}"   // → object
+```
+
+The token has to be the entire string — with text around it the result is
+always a string. The same holds inside `grid.header`, where every nested key is
+resolved (`"extra": { "steps": "{{steps}}" }`).
+
+Not everything is resolved, and a placeholder written in the wrong place is
+silently left as literal text: `grid.type`, `grid.styleClass`, `grid.sideBar`,
+`grid.header.class` and the keys **inside** a page-level `extra` are all taken
+as written.
+
 ### Grid
 
 ```jsonc