Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
68 commits
Select commit Hold shift + click to select a range
b660f2e
test(forms): pin the runtime behavior the V2 field rules rely on
AndrewKirkovski Oct 1, 2026
4d2dd8b
refactor(forms): move the shared text rules into form_text
AndrewKirkovski Oct 1, 2026
cbd6df0
feat(forms): V2 standard fields: text, textarea, number, email, date,…
AndrewKirkovski Oct 1, 2026
60ba956
feat(forms-ui): render the V2 standard fields in the fields form
AndrewKirkovski Oct 1, 2026
b60ad40
build(forms-ui): rebuild the wippy-form bundle for V2 fields
AndrewKirkovski Oct 1, 2026
e528d23
docs(forms-ui): document the fields form and the V2 answer shapes
AndrewKirkovski Oct 1, 2026
7a6c230
fix(forms): refuse a step check on a stored step or minimum outside t…
AndrewKirkovski Oct 1, 2026
c642493
fix(forms-ui): leave a text field's pattern to the server
AndrewKirkovski Oct 1, 2026
53c4252
build(forms-ui): rebuild the wippy-form bundle without client pattern…
AndrewKirkovski Oct 1, 2026
91840d7
docs(forms-ui): say the pattern is checked by the server on submit, a…
AndrewKirkovski Oct 1, 2026
84ff04d
docs(forms): describe the standard field types in the README
AndrewKirkovski Oct 1, 2026
2f97ffd
fix(forms-ui): keep what is typed in the date box and give the calend…
AndrewKirkovski Oct 1, 2026
2bf4074
fix(forms-ui): mark every radio and checkbox of a choice group in err…
AndrewKirkovski Oct 1, 2026
53f9482
fix(forms-ui): keep the "N questions need attention" status in step w…
AndrewKirkovski Oct 1, 2026
4f3827e
build(forms-ui): rebuild the wippy-form bundle for the V2 field-contr…
AndrewKirkovski Oct 1, 2026
4a19329
docs(forms-ui): document the date box, the calendar part, the choice …
AndrewKirkovski Oct 1, 2026
c718b81
Merge codex/session-forms-v1-release into codex/session-forms-v2
AndrewKirkovski Oct 1, 2026
9de375b
fix(forms): refuse a pattern repeat count that starts with a zero
AndrewKirkovski Oct 1, 2026
257438c
fix(forms): compile a pattern in one place and keep the compiled expr…
AndrewKirkovski Oct 1, 2026
9aa28d3
fix(forms-ui): pick the number keypad by what can be typed, stop emai…
AndrewKirkovski Oct 1, 2026
d35a683
fix(forms): describe the pattern subset in the ask_user schema as the…
AndrewKirkovski Oct 1, 2026
8638574
fix(forms-ui): open the date calendar on a touch tap, keep the month …
AndrewKirkovski Oct 1, 2026
efb4efc
refactor(forms): one sequence for every free-text answer
AndrewKirkovski Oct 1, 2026
c3e192a
fix(forms-ui): link a choice's description and error to its inputs, a…
AndrewKirkovski Oct 1, 2026
89ed030
fix(forms): report only unsupported_type for a field of an unknown type
AndrewKirkovski Oct 1, 2026
4aa8905
test(forms): make the conformance fixture and runner check what they …
AndrewKirkovski Oct 1, 2026
e621ff6
test(forms): pin that a default only prefills, and a real pattern ref…
AndrewKirkovski Oct 1, 2026
fc295fe
test(forms-ui): fail when the conformance fixture is missing, and pro…
AndrewKirkovski Oct 1, 2026
9c8298e
refactor(forms-ui): drop four unused answer helpers, share one Other-…
AndrewKirkovski Oct 1, 2026
8e04d2a
test(forms): pin that a number step wider than its range still allows…
AndrewKirkovski Oct 1, 2026
a9e023d
fix(forms-ui): announce a submit failure once, and say a form-level e…
AndrewKirkovski Oct 1, 2026
0584b14
fix(forms): take the number range in the messages from the limit, and…
AndrewKirkovski Oct 1, 2026
a384582
refactor(forms-ui): one form header, one "cannot answer here" notice,…
AndrewKirkovski Oct 1, 2026
4bfc01d
docs(forms-ui): document the number keyboard, the touch tap, the plac…
AndrewKirkovski Oct 1, 2026
960d3d6
refactor(forms): one whole-number test, and a home for the definition…
AndrewKirkovski Oct 1, 2026
ceb4a78
test(forms): state the anchor of the fixtures volume and say what to …
AndrewKirkovski Oct 1, 2026
b7cf4aa
docs(forms): say that only the server evaluates a pattern, and tidy t…
AndrewKirkovski Oct 1, 2026
665f9b5
fix(forms-ui): bound the date control instead of overriding the calen…
AndrewKirkovski Oct 1, 2026
6b96da5
test(forms-ui): reword a comment the compliance gate read as an any-cast
AndrewKirkovski Oct 1, 2026
11f91fe
build(forms-ui): rebuild the wippy-form bundle for the review fixes
AndrewKirkovski Oct 1, 2026
c1aebc8
fix(forms): satisfy the linter in the new answer helper and the new t…
AndrewKirkovski Oct 1, 2026
01952b9
fix(forms-ui): give the date box focus back when its calendar closes …
AndrewKirkovski Oct 1, 2026
ef4468d
build(forms-ui): rebuild the wippy-form bundle for the date focus fix
AndrewKirkovski Oct 1, 2026
0aa49e1
perf(forms-ui): hand fields without errors one shared empty list
AndrewKirkovski Oct 1, 2026
ae79ce0
Merge the V1 release into session forms V2
AndrewKirkovski Oct 1, 2026
0e3f5d4
build(forms-ui): rebuild the bundles after the V1 release merge
AndrewKirkovski Oct 1, 2026
43d9dfe
feat(forms): split choice forms and forms with fields into two traits
AndrewKirkovski Oct 1, 2026
477e958
fix(forms): list only the calling tool's types for an unknown field type
AndrewKirkovski Oct 1, 2026
0e9f373
refactor(forms-ui): share the answered status line between both answe…
AndrewKirkovski Oct 1, 2026
1c4681d
build(forms-answers): keep the build from using a parent folder's Pos…
AndrewKirkovski Oct 1, 2026
c88608b
chore: merge Session Forms V1 release into V2
AndrewKirkovski Nov 5, 2026
8f24b1e
test(forms): revalidate standard fields against a definition changed …
AndrewKirkovski Nov 5, 2026
f1d6566
fix(forms-ui): keep number and boolean answers when reading stored an…
AndrewKirkovski Nov 5, 2026
9929b40
refactor(forms-ui): give the question card the shared draft and seria…
AndrewKirkovski Nov 5, 2026
fc20d64
refactor(forms-ui): drop the calendar theme class observer
AndrewKirkovski Nov 5, 2026
d518ac5
test(forms): satisfy the 0.3.57a linter in the standard field tests
AndrewKirkovski Nov 5, 2026
b0831e2
fix(forms): limit a pattern's size with its repeats written out
AndrewKirkovski Nov 5, 2026
141d728
fix(forms): set the pattern size limit to 100
AndrewKirkovski Nov 5, 2026
1a6c5f0
Merge the Session Forms V1 release into V2
AndrewKirkovski Nov 6, 2026
f36500b
fix(forms): close the server defects from the V2 review
AndrewKirkovski Nov 6, 2026
8cf3d87
test(forms): cover stored V1 forms, both traits and refused defaults
AndrewKirkovski Nov 6, 2026
ac37864
refactor(forms): give repeated server rules one owner
AndrewKirkovski Nov 6, 2026
f663666
fix(forms-ui): close the fields form defects from the V2 review
AndrewKirkovski Nov 6, 2026
04c4492
build(forms): rebuild the wippy-form bundle for the V2 review fixes
AndrewKirkovski Nov 6, 2026
ef1c277
feat(forms-ui): show a sending state on the fields form Submit button
AndrewKirkovski Nov 6, 2026
133e6ed
build(forms): rebuild the wippy-form bundle for the Submit sending state
AndrewKirkovski Nov 6, 2026
fd3c87e
Merge Session Forms V1 fix: keep a form answer whole across a checkpoint
AndrewKirkovski Nov 6, 2026
dcdec89
test(forms): keep an 8000-character textarea record across a checkpoint
AndrewKirkovski Nov 6, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
47 changes: 33 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -198,8 +198,10 @@ source snapshots without Git metadata.
Dependencies, the database, environment file, backups, and benchmark reports
stay under `TEST_ARTIFACTS` (default `/tmp/wippy-session-tests`). The database is
backed up before each reset. Override `TEST_BACKUP_DIR` for another backup
location or `TEST_CONFIG` for an external runtime configuration. These targets
require Wippy, Bash, jq, and SQLite; set `WIPPY` when it is not on PATH.
location or `TEST_CONFIG` for an external runtime configuration. An external
configuration must also carry the `app.forms:fixtures:directory` override that
`make prepare` writes, or the form fixture suites cannot find their files. These
targets require Wippy, Bash, jq, and SQLite; set `WIPPY` when it is not on PATH.

## Session retirement

Expand Down Expand Up @@ -629,24 +631,36 @@ Only `session:`-prefixed topics are relayed to clients.

## Session Forms

Session forms let an agent ask the user structured choice questions with the
`ask_user` tool and get the answer back as an ordinary user message. A form
is stored as a `wippy-component-tag-1.0` artifact (see Artifacts above) with
one extra metadata key, `meta.session_form`; no new SQL table is used.
Session forms let an agent ask the user structured questions in the chat and
get the answer back as an ordinary user message. A form is stored as a
`wippy-component-tag-1.0` artifact (see Artifacts above) with one extra
metadata key, `meta.session_form`; no new SQL table is used.

### Enable

Add the trait to an agent:
Add one of the two traits to an agent:

```yaml
traits:
# Choice questions only.
- id: wippy.session.forms:ask_user
# Or: choice questions and the standard fields.
# - id: wippy.session.forms:ask_user_fields
```

The agent gets `ask_user` (create a form; ends the turn) and `read_form`
(read an earlier form's questions, or its answer record, by `form_id`). Every
agent, with or without the trait, gets a bounded index of the session's forms
injected into its prompt so it can find a form id without the trait.
| Trait | Tool it adds | Field types |
| --- | --- | --- |
| `wippy.session.forms:ask_user` | `ask_user` | `choice` |
| `wippy.session.forms:ask_user_fields` | `ask_user_fields` | `choice`, `text`, `textarea`, `number`, `email`, `date`, `checkbox` |

The tool creates a form and ends the turn. Each tool's schema lists only its
own field types, and the server refuses any other type from it with
`unsupported_type`, so an agent with `ask_user` can never create a form with
standard fields. Both traits also add `read_form` (read an earlier form's
questions, or its answer record, by `form_id`). Attach one of them: the two
tools have different names, so an agent with both gets both tools and both
prompts. Every agent, with or without a trait, gets a bounded index of the
session's forms injected into its prompt so it can find a form id.

### API

Expand All @@ -657,8 +671,13 @@ commits the accepted answer and its user message in one transaction, then
wakes the owning session process; a missed wake-up is recovered from the
stored row on the next session start.

V1 supports choice fields only: single selection, multiple selection,
optional/required, notes on a chosen option, and a free-text "Other" answer.
A form holds choice fields (single or multiple selection, notes on a chosen
option, a free-text "Other" answer) and standard fields: `text`, `textarea`,
`email`, `number`, `date` and `checkbox`, each optional or required. A form
with only choice fields is form version 1; a form with any standard field is
version 2, and an older `wippy-form` shows a "needs a newer version" notice
for it. The server checks every answer, including a text field's `pattern`,
which the browser never evaluates.

### Answers and steering

Expand All @@ -676,7 +695,7 @@ that asks a form still ends there; steering sent during that turn starts the
next turn.

See [Session Forms (framework)](https://docs.wippy.ai/en/framework/session-forms)
for the full `ask_user` / `read_form` contract, the answer record shape, late
for the full `ask_user`, `ask_user_fields` and `read_form` contract, the answer record shape, late
answers, and how an answer is admitted into the conversation, and
[Session Forms (frontend)](https://docs.wippy.ai/en/frontend/micro-frontends/session-forms)
for the `wippy-form` / `wippy-form-answers` components and the HTTP contract
Expand Down
6 changes: 6 additions & 0 deletions frontend/wippy-form-answers/vite.config.ts
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,12 @@ export default defineConfig({
plugins: [
wippyComponentPlugin(),
],
// An inline PostCSS config stops Vite from searching parent folders, where a
// checkout nested in another project finds that project's Tailwind setup.
// The element's one rule needs no PostCSS plugin.
css: {
postcss: {},
},
build: {
target: 'esnext',
// The npm build scripts pass `--outDir`, so the output path is not set here.
Expand Down
Loading
Loading