@terreno/blocks 57.12.0 → 57.13.0

package/src/__snapshots__/prompt.test.ts.snap

@@ -0,0 +1,530 @@
+// Bun Snapshot v1, https://bun.sh/docs/test/snapshots
+
+exports[`blocksPromptSection with richBlocks false matches the pre-rich-blocks prompt for allowHtml, even with stepper and checklist actions 1`] = `
+"Your entire reply is one document; no prose outside it; no text before tool calls.
+The document is YAML or JSON. Keys, when present, are in this order: v, datasets, blocks.
+v is 1.
+Block types: heading, text, metric, badge, divider, context, chart, table, actions, columns, card, html, callout, image, details.
+An html field is at most 100000 bytes.
+html requires html and may set title and height (sm, md, or lg). It is a display preview: no scripts, no links, no network.
+callout requires text and may set status to info, warning, or alert.
+image requires alt and src. src is a data:image URL, a file: ref, or an https URL on an allowed host.
+Do not emit an https image src. Use a data:image URL or a file: ref.
+details requires title and text.
+heading requires text. text requires markdown. metric requires label and value. badge requires text. context requires text.
+chart kind is line, bar, area, or donut. Bind it with data, x, and y, or with points of label and value.
+table requires data, the name of a dataset. actions requires id and elements.
+An element is a button (id, text, action) or a segmented control (id, target, options of label and data).
+action.kind is reply (text), open (url or route, exactly one), select (target and data), or callback (name and optional payload).
+columns has 2 to 4 children. card has children and an optional title. Do not nest columns or card inside columns or card.
+At most 50 blocks, including nested blocks.
+Depth is at most 2.
+An actions block has at most 25 elements.
+columns has 2 to 4 children.
+At most 8 datasets.
+An inline dataset has at most 500 rows and 12 columns.
+A ref dataset limit is at most 1000.
+A text block has at most 4000 characters.
+A document has at most 20000 characters of text.
+Heading text is at most 200 characters.
+Badge text is at most 80 characters.
+Context text is at most 280 characters.
+A card title is at most 120 characters.
+A metric label is at most 80 characters, its value 80, its delta 40, and its helper 120.
+A bar chart warns above 60 categories.
+A donut chart warns above 8 slices.
+Use the datasetId a tool returned; never paste more than 500 rows.
+No callback names are registered. Do not emit kind callback.
+Example with data:
+v: 1
+datasets:
+  signups:
+    columns:
+      - name: month
+        type: string
+      - name: count
+        type: number
+    rows:
+      - [Jan, 120]
+      - [Feb, 180]
+blocks:
+  - type: chart
+    id: signups_chart
+    kind: bar
+    data: signups
+    x: month
+    y: count
+    title: Signups by month
+  - type: actions
+    id: followups
+    elements:
+      - type: button
+        id: weekly
+        text: Show weekly
+        action:
+          kind: reply
+          text: Show weekly signups for this quarter
+Example with prose only:
+v: 1
+blocks:
+  - type: text
+    markdown: I could not find any signups for that range. Try a wider date window."
+`;
+
+exports[`blocksPromptSection with richBlocks false matches the pre-rich-blocks prompt for everything, even with stepper and checklist actions 1`] = `
+"Your entire reply is one document; no prose outside it; no text before tool calls.
+The document is YAML or JSON. Keys, when present, are in this order: v, datasets, blocks.
+v is 1.
+Block types: heading, text, metric, badge, divider, context, chart, table, actions, columns, card, html, callout, image, details.
+An html field is at most 100000 bytes.
+html requires html and may set title and height (sm, md, or lg). It is a display preview: no scripts, no links, no network.
+callout requires text and may set status to info, warning, or alert.
+image requires alt and src. src is a data:image URL, a file: ref, or an https URL on an allowed host.
+An https image src must use one of these hosts: cdn.example.com.
+details requires title and text.
+heading requires text. text requires markdown. metric requires label and value. badge requires text. context requires text.
+chart kind is line, bar, area, or donut. Bind it with data, x, and y, or with points of label and value.
+table requires data, the name of a dataset. actions requires id and elements.
+An element is a button (id, text, action) or a segmented control (id, target, options of label and data).
+action.kind is reply (text), open (url or route, exactly one), select (target and data), or callback (name and optional payload).
+columns has 2 to 4 children. card has children and an optional title. Do not nest columns or card inside columns or card.
+At most 50 blocks, including nested blocks.
+Depth is at most 2.
+An actions block has at most 25 elements.
+columns has 2 to 4 children.
+At most 8 datasets.
+An inline dataset has at most 500 rows and 12 columns.
+A ref dataset limit is at most 1000.
+A text block has at most 4000 characters.
+A document has at most 20000 characters of text.
+Heading text is at most 200 characters.
+Badge text is at most 80 characters.
+Context text is at most 280 characters.
+A card title is at most 120 characters.
+A metric label is at most 80 characters, its value 80, its delta 40, and its helper 120.
+A bar chart warns above 60 categories.
+A donut chart warns above 8 slices.
+Use the datasetId a tool returned; never paste more than 500 rows.
+A callback name must be one of: approve, scaleStepper.
+Example with data:
+v: 1
+datasets:
+  signups:
+    columns:
+      - name: month
+        type: string
+      - name: count
+        type: number
+    rows:
+      - [Jan, 120]
+      - [Feb, 180]
+blocks:
+  - type: chart
+    id: signups_chart
+    kind: bar
+    data: signups
+    x: month
+    y: count
+    title: Signups by month
+  - type: actions
+    id: followups
+    elements:
+      - type: button
+        id: weekly
+        text: Show weekly
+        action:
+          kind: reply
+          text: Show weekly signups for this quarter
+Example with prose only:
+v: 1
+blocks:
+  - type: text
+    markdown: I could not find any signups for that range. Try a wider date window."
+`;
+
+exports[`blocksPromptSection with richBlocks false matches the pre-rich-blocks prompt for hostActions, even with stepper and checklist actions 1`] = `
+"Your entire reply is one document; no prose outside it; no text before tool calls.
+The document is YAML or JSON. Keys, when present, are in this order: v, datasets, blocks.
+v is 1.
+Block types: heading, text, metric, badge, divider, context, chart, table, actions, columns, card, callout, image, details. Do not emit type html.
+An html field is at most 100000 bytes.
+callout requires text and may set status to info, warning, or alert.
+image requires alt and src. src is a data:image URL, a file: ref, or an https URL on an allowed host.
+Do not emit an https image src. Use a data:image URL or a file: ref.
+details requires title and text.
+heading requires text. text requires markdown. metric requires label and value. badge requires text. context requires text.
+chart kind is line, bar, area, or donut. Bind it with data, x, and y, or with points of label and value.
+table requires data, the name of a dataset. actions requires id and elements.
+An element is a button (id, text, action) or a segmented control (id, target, options of label and data).
+action.kind is reply (text), open (url or route, exactly one), select (target and data), or callback (name and optional payload).
+columns has 2 to 4 children. card has children and an optional title. Do not nest columns or card inside columns or card.
+At most 50 blocks, including nested blocks.
+Depth is at most 2.
+An actions block has at most 25 elements.
+columns has 2 to 4 children.
+At most 8 datasets.
+An inline dataset has at most 500 rows and 12 columns.
+A ref dataset limit is at most 1000.
+A text block has at most 4000 characters.
+A document has at most 20000 characters of text.
+Heading text is at most 200 characters.
+Badge text is at most 80 characters.
+Context text is at most 280 characters.
+A card title is at most 120 characters.
+A metric label is at most 80 characters, its value 80, its delta 40, and its helper 120.
+A bar chart warns above 60 categories.
+A donut chart warns above 8 slices.
+Use the datasetId a tool returned; never paste more than 500 rows.
+A callback name must be one of: exportDataset.
+Example with data:
+v: 1
+datasets:
+  signups:
+    columns:
+      - name: month
+        type: string
+      - name: count
+        type: number
+    rows:
+      - [Jan, 120]
+      - [Feb, 180]
+blocks:
+  - type: chart
+    id: signups_chart
+    kind: bar
+    data: signups
+    x: month
+    y: count
+    title: Signups by month
+  - type: actions
+    id: followups
+    elements:
+      - type: button
+        id: weekly
+        text: Show weekly
+        action:
+          kind: reply
+          text: Show weekly signups for this quarter
+Example with prose only:
+v: 1
+blocks:
+  - type: text
+    markdown: I could not find any signups for that range. Try a wider date window."
+`;
+
+exports[`blocksPromptSection with richBlocks false matches the pre-rich-blocks prompt for imageHosts, even with stepper and checklist actions 1`] = `
+"Your entire reply is one document; no prose outside it; no text before tool calls.
+The document is YAML or JSON. Keys, when present, are in this order: v, datasets, blocks.
+v is 1.
+Block types: heading, text, metric, badge, divider, context, chart, table, actions, columns, card, callout, image, details. Do not emit type html.
+An html field is at most 100000 bytes.
+callout requires text and may set status to info, warning, or alert.
+image requires alt and src. src is a data:image URL, a file: ref, or an https URL on an allowed host.
+An https image src must use one of these hosts: cdn.example.com.
+details requires title and text.
+heading requires text. text requires markdown. metric requires label and value. badge requires text. context requires text.
+chart kind is line, bar, area, or donut. Bind it with data, x, and y, or with points of label and value.
+table requires data, the name of a dataset. actions requires id and elements.
+An element is a button (id, text, action) or a segmented control (id, target, options of label and data).
+action.kind is reply (text), open (url or route, exactly one), select (target and data), or callback (name and optional payload).
+columns has 2 to 4 children. card has children and an optional title. Do not nest columns or card inside columns or card.
+At most 50 blocks, including nested blocks.
+Depth is at most 2.
+An actions block has at most 25 elements.
+columns has 2 to 4 children.
+At most 8 datasets.
+An inline dataset has at most 500 rows and 12 columns.
+A ref dataset limit is at most 1000.
+A text block has at most 4000 characters.
+A document has at most 20000 characters of text.
+Heading text is at most 200 characters.
+Badge text is at most 80 characters.
+Context text is at most 280 characters.
+A card title is at most 120 characters.
+A metric label is at most 80 characters, its value 80, its delta 40, and its helper 120.
+A bar chart warns above 60 categories.
+A donut chart warns above 8 slices.
+Use the datasetId a tool returned; never paste more than 500 rows.
+No callback names are registered. Do not emit kind callback.
+Example with data:
+v: 1
+datasets:
+  signups:
+    columns:
+      - name: month
+        type: string
+      - name: count
+        type: number
+    rows:
+      - [Jan, 120]
+      - [Feb, 180]
+blocks:
+  - type: chart
+    id: signups_chart
+    kind: bar
+    data: signups
+    x: month
+    y: count
+    title: Signups by month
+  - type: actions
+    id: followups
+    elements:
+      - type: button
+        id: weekly
+        text: Show weekly
+        action:
+          kind: reply
+          text: Show weekly signups for this quarter
+Example with prose only:
+v: 1
+blocks:
+  - type: text
+    markdown: I could not find any signups for that range. Try a wider date window."
+`;
+
+exports[`blocksPromptSection with richBlocks false matches the pre-rich-blocks prompt for none, even with stepper and checklist actions 1`] = `
+"Your entire reply is one document; no prose outside it; no text before tool calls.
+The document is YAML or JSON. Keys, when present, are in this order: v, datasets, blocks.
+v is 1.
+Block types: heading, text, metric, badge, divider, context, chart, table, actions, columns, card, callout, image, details. Do not emit type html.
+An html field is at most 100000 bytes.
+callout requires text and may set status to info, warning, or alert.
+image requires alt and src. src is a data:image URL, a file: ref, or an https URL on an allowed host.
+Do not emit an https image src. Use a data:image URL or a file: ref.
+details requires title and text.
+heading requires text. text requires markdown. metric requires label and value. badge requires text. context requires text.
+chart kind is line, bar, area, or donut. Bind it with data, x, and y, or with points of label and value.
+table requires data, the name of a dataset. actions requires id and elements.
+An element is a button (id, text, action) or a segmented control (id, target, options of label and data).
+action.kind is reply (text), open (url or route, exactly one), select (target and data), or callback (name and optional payload).
+columns has 2 to 4 children. card has children and an optional title. Do not nest columns or card inside columns or card.
+At most 50 blocks, including nested blocks.
+Depth is at most 2.
+An actions block has at most 25 elements.
+columns has 2 to 4 children.
+At most 8 datasets.
+An inline dataset has at most 500 rows and 12 columns.
+A ref dataset limit is at most 1000.
+A text block has at most 4000 characters.
+A document has at most 20000 characters of text.
+Heading text is at most 200 characters.
+Badge text is at most 80 characters.
+Context text is at most 280 characters.
+A card title is at most 120 characters.
+A metric label is at most 80 characters, its value 80, its delta 40, and its helper 120.
+A bar chart warns above 60 categories.
+A donut chart warns above 8 slices.
+Use the datasetId a tool returned; never paste more than 500 rows.
+No callback names are registered. Do not emit kind callback.
+Example with data:
+v: 1
+datasets:
+  signups:
+    columns:
+      - name: month
+        type: string
+      - name: count
+        type: number
+    rows:
+      - [Jan, 120]
+      - [Feb, 180]
+blocks:
+  - type: chart
+    id: signups_chart
+    kind: bar
+    data: signups
+    x: month
+    y: count
+    title: Signups by month
+  - type: actions
+    id: followups
+    elements:
+      - type: button
+        id: weekly
+        text: Show weekly
+        action:
+          kind: reply
+          text: Show weekly signups for this quarter
+Example with prose only:
+v: 1
+blocks:
+  - type: text
+    markdown: I could not find any signups for that range. Try a wider date window."
+`;
+
+exports[`blocksPromptSection with richBlocks on matches the full rich-blocks prompt with stepper and checklist actions 1`] = `
+"Your entire reply is one document; no prose outside it; no text before tool calls.
+The document is YAML or JSON. Keys, when present, are in this order: v, datasets, blocks.
+v is 1.
+Block types: heading, text, metric, badge, divider, context, chart, table, actions, columns, card, callout, image, details, stepper, checklist, gallery, list. Do not emit type html.
+An html field is at most 100000 bytes.
+callout requires text and may set status to info, warning, or alert.
+image requires alt and src. src is a data:image URL, a file: ref, or an https URL on an allowed host.
+An https image src must use one of these hosts: images.example.com.
+details requires title and text.
+stepper requires id, label, value, min, max, and callback (name and optional payload). It may set step (above 0, default 1), unit, itemsTitle, items, and note. min is below max, and value is between them.
+Its decrease and increase buttons send the callback with payload.value set to the next value. The host returns the updated stepper, so write item amounts for the starting value.
+A stepper callback name must be one of: scaleStepper.
+A stepper item requires label and amount. It may set unit, decimals, and round (nearest or up).
+A stepper id is at most 54 characters. No other id may be <id>_decrease or <id>_increase.
+A stepper label and itemsTitle are at most 80 characters, its unit 40, and its note 280.
+A stepper has at most 12 items. An item label is at most 80 characters, its unit 20, and decimals is 0 to 3.
+checklist requires id and items, and may set title. It shows a done count such as 2 of 8.
+A checklist item requires id and text. It may set meta (a short label such as a time, shown under the text), detail (a muted line under that), and checked (true or false).
+Set a checklist callback name to one of: toggleChecklist. Its payload is optional. Each tick sends the callback with payload.itemId, payload.checked, and payload.state, and the host returns the updated checklist.
+A checklist id is at most 31 characters and an item id 32. Item ids are unique in the checklist, and no other id may be <id>_<item id>.
+A checklist has 1 to 30 items. Its title is at most 120 characters, an item text 120, an item meta 40, and an item detail 280.
+gallery requires images: 2 to 6 photos shown together. Each image requires src and alt, and may set caption. Each src follows the image src rules above.
+A gallery image alt is at most 200 characters and its caption 120.
+list requires items: 1 to 12 entries stacked one under another. Each item requires title, and may set text (plain text, not markdown), meta (a short label such as a time or a price), and image (src and alt, a thumbnail). Each image src follows the image src rules above.
+A list item title is at most 120 characters, its text 500, its meta 40, and its image alt 200.
+A card may set eyebrow, a short label shown small above its title. An eyebrow is at most 60 characters.
+heading requires text. text requires markdown. metric requires label and value. badge requires text. context requires text.
+chart kind is line, bar, area, or donut. Bind it with data, x, and y, or with points of label and value.
+table requires data, the name of a dataset. actions requires id and elements.
+An element is a button (id, text, action) or a segmented control (id, target, options of label and data).
+action.kind is reply (text), open (url or route, exactly one), select (target and data), or callback (name and optional payload).
+action.kind may also be copy: it copies to the clipboard on the device and never reaches the host. A copy action sets exactly one of text (at most 4000 characters, copied as written) or target (the id of a stepper, checklist, list, table, or text block in this document, whose current contents are copied).
+columns has 2 to 4 children. card has children and an optional title. Do not nest columns or card inside columns or card.
+At most 50 blocks, including nested blocks.
+Depth is at most 2.
+An actions block has at most 25 elements.
+columns has 2 to 4 children.
+At most 8 datasets.
+An inline dataset has at most 500 rows and 12 columns.
+A ref dataset limit is at most 1000.
+A text block has at most 4000 characters.
+A document has at most 20000 characters of text.
+Heading text is at most 200 characters.
+Badge text is at most 80 characters.
+Context text is at most 280 characters.
+A card title is at most 120 characters.
+A metric label is at most 80 characters, its value 80, its delta 40, and its helper 120.
+A bar chart warns above 60 categories.
+A donut chart warns above 8 slices.
+Use the datasetId a tool returned; never paste more than 500 rows.
+A callback name must be one of: approve, scaleStepper, toggleChecklist.
+Example with data:
+v: 1
+datasets:
+  signups:
+    columns:
+      - name: month
+        type: string
+      - name: count
+        type: number
+    rows:
+      - [Jan, 120]
+      - [Feb, 180]
+blocks:
+  - type: chart
+    id: signups_chart
+    kind: bar
+    data: signups
+    x: month
+    y: count
+    title: Signups by month
+  - type: actions
+    id: followups
+    elements:
+      - type: button
+        id: weekly
+        text: Show weekly
+        action:
+          kind: reply
+          text: Show weekly signups for this quarter
+Example with prose only:
+v: 1
+blocks:
+  - type: text
+    markdown: I could not find any signups for that range. Try a wider date window."
+`;
+
+exports[`blocksPromptSection with richBlocks on matches the full rich-blocks prompt with html allowed 1`] = `
+"Your entire reply is one document; no prose outside it; no text before tool calls.
+The document is YAML or JSON. Keys, when present, are in this order: v, datasets, blocks.
+v is 1.
+Block types: heading, text, metric, badge, divider, context, chart, table, actions, columns, card, html, callout, image, details, stepper, checklist, gallery, list.
+An html field is at most 100000 bytes.
+html requires html and may set title and height (sm, md, or lg). It is a display preview: no scripts, no links, no network.
+callout requires text and may set status to info, warning, or alert.
+image requires alt and src. src is a data:image URL, a file: ref, or an https URL on an allowed host.
+An https image src must use one of these hosts: images.example.com.
+details requires title and text.
+stepper requires id, label, value, min, max, and callback (name and optional payload). It may set step (above 0, default 1), unit, itemsTitle, items, and note. min is below max, and value is between them.
+Its decrease and increase buttons send the callback with payload.value set to the next value. The host returns the updated stepper, so write item amounts for the starting value.
+A stepper callback name must be one of: scaleStepper.
+A stepper item requires label and amount. It may set unit, decimals, and round (nearest or up).
+A stepper id is at most 54 characters. No other id may be <id>_decrease or <id>_increase.
+A stepper label and itemsTitle are at most 80 characters, its unit 40, and its note 280.
+A stepper has at most 12 items. An item label is at most 80 characters, its unit 20, and decimals is 0 to 3.
+checklist requires id and items, and may set title. It shows a done count such as 2 of 8.
+A checklist item requires id and text. It may set meta (a short label such as a time, shown under the text), detail (a muted line under that), and checked (true or false).
+Set a checklist callback name to one of: toggleChecklist. Its payload is optional. Each tick sends the callback with payload.itemId, payload.checked, and payload.state, and the host returns the updated checklist.
+A checklist id is at most 31 characters and an item id 32. Item ids are unique in the checklist, and no other id may be <id>_<item id>.
+A checklist has 1 to 30 items. Its title is at most 120 characters, an item text 120, an item meta 40, and an item detail 280.
+gallery requires images: 2 to 6 photos shown together. Each image requires src and alt, and may set caption. Each src follows the image src rules above.
+A gallery image alt is at most 200 characters and its caption 120.
+list requires items: 1 to 12 entries stacked one under another. Each item requires title, and may set text (plain text, not markdown), meta (a short label such as a time or a price), and image (src and alt, a thumbnail). Each image src follows the image src rules above.
+A list item title is at most 120 characters, its text 500, its meta 40, and its image alt 200.
+A card may set eyebrow, a short label shown small above its title. An eyebrow is at most 60 characters.
+heading requires text. text requires markdown. metric requires label and value. badge requires text. context requires text.
+chart kind is line, bar, area, or donut. Bind it with data, x, and y, or with points of label and value.
+table requires data, the name of a dataset. actions requires id and elements.
+An element is a button (id, text, action) or a segmented control (id, target, options of label and data).
+action.kind is reply (text), open (url or route, exactly one), select (target and data), or callback (name and optional payload).
+action.kind may also be copy: it copies to the clipboard on the device and never reaches the host. A copy action sets exactly one of text (at most 4000 characters, copied as written) or target (the id of a stepper, checklist, list, table, or text block in this document, whose current contents are copied).
+columns has 2 to 4 children. card has children and an optional title. Do not nest columns or card inside columns or card.
+At most 50 blocks, including nested blocks.
+Depth is at most 2.
+An actions block has at most 25 elements.
+columns has 2 to 4 children.
+At most 8 datasets.
+An inline dataset has at most 500 rows and 12 columns.
+A ref dataset limit is at most 1000.
+A text block has at most 4000 characters.
+A document has at most 20000 characters of text.
+Heading text is at most 200 characters.
+Badge text is at most 80 characters.
+Context text is at most 280 characters.
+A card title is at most 120 characters.
+A metric label is at most 80 characters, its value 80, its delta 40, and its helper 120.
+A bar chart warns above 60 categories.
+A donut chart warns above 8 slices.
+Use the datasetId a tool returned; never paste more than 500 rows.
+A callback name must be one of: approve, scaleStepper, toggleChecklist.
+Example with data:
+v: 1
+datasets:
+  signups:
+    columns:
+      - name: month
+        type: string
+      - name: count
+        type: number
+    rows:
+      - [Jan, 120]
+      - [Feb, 180]
+blocks:
+  - type: chart
+    id: signups_chart
+    kind: bar
+    data: signups
+    x: month
+    y: count
+    title: Signups by month
+  - type: actions
+    id: followups
+    elements:
+      - type: button
+        id: weekly
+        text: Show weekly
+        action:
+          kind: reply
+          text: Show weekly signups for this quarter
+Example with prose only:
+v: 1
+blocks:
+  - type: text
+    markdown: I could not find any signups for that range. Try a wider date window."
+`;

package/src/errors.ts

@@ -2,6 +2,8 @@
 export const BLOCK_ERROR_CODES = {
   COLUMN_NOT_FOUND: "A chart or table names a column the dataset does not have.",
   COLUMN_TYPE_MISMATCH: "A column value does not match the column type.",
+  COPY_TARGET_INVALID:
+    "A copy action names a block that is not a stepper, checklist, list, table, or text block.",
   DATASET_NOT_FOUND: "A chart or table names a dataset the document does not define.",
   DATASET_TOO_LARGE: "A dataset has more rows or columns than allowed.",
   DEPTH_EXCEEDED: "A columns or card block is nested inside another columns or card block.",
@@ -16,6 +18,8 @@ export const BLOCK_ERROR_CODES = {
   KEY_ORDER: "Top-level keys are not in the order v, datasets, blocks.",
   MISSING_REQUIRED: "A required field is missing.",
   NOT_A_DOCUMENT: "The reply is not one YAML or JSON mapping with a v field.",
+  OUT_OF_RANGE:
+    "A number is outside its allowed range, such as a stepper value outside min and max.",
   ROW_ARITY_MISMATCH: "A dataset row does not have one value per column.",
   SELECT_TARGET_INVALID: "A select action names a block that is not a chart or table.",
   TABLE_TOO_WIDE: "A table lists more columns than allowed.",