Skip to content

Add p.inputField helper; clarify readInput/maxTurns/tools docs#100

Merged
pelikhan merged 2 commits into
mainfrom
copilot/rig-tasks-daily-evaluation-2026-07-24-ac66059c-f9fe-4025-b931-2b85a7128150
Jul 25, 2026
Merged

Add p.inputField helper; clarify readInput/maxTurns/tools docs#100
pelikhan merged 2 commits into
mainfrom
copilot/rig-tasks-daily-evaluation-2026-07-24-ac66059c-f9fe-4025-b931-2b85a7128150

Conversation

Copilot AI commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

Daily evaluation identified several undocumented patterns and missing API ergonomics. The ${"input.fieldName"} workaround for referencing non-path input values in prompt templates had no type-safety, no autocomplete, and no documentation.

New API: p.inputField(field)

Returns "input.<field>" for explicit reference to a caller-supplied input field in prompt prose — a documented, type-safe replacement for the opaque string literal:

// Before: opaque, undocumented, looks like a no-op literal
instructions: p`Merge config files listed in ${"input.files"}.`

// After: explicit, discoverable, correct semantic
instructions: p`Merge config files listed in ${p.inputField("files")}.`

Use p.inputField when the field value itself (array, string, number) should appear in prose. Use p.readInput(field) when the field holds a single file path whose contents the model should read.

Documentation fixes

  • SKILL.md / prompt-intents.md: p.readInput now explicitly says "single path" (not array); added p.inputField to the helper table and a dedicated "Referencing non-path input values in prose" section with example
  • composition.md: concrete maxTurns counting — maxTurns: 3 = 1 initial attempt + 2 repair retries
  • agent-api.md: added defineTool vs p.bash decision table covering 6 situations
  • README.md: added p.readInput and p.inputField to prompt intents section

…back

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title [WIP] Update daily rig evaluation for 2026-07-24 Add p.inputField helper; clarify readInput/maxTurns/tools docs Jul 24, 2026
Copilot AI requested a review from pelikhan July 24, 2026 21:30
@pelikhan
pelikhan marked this pull request as ready for review July 25, 2026 02:28
@pelikhan
pelikhan merged commit 4d73b3b into main Jul 25, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[rig-tasks] Daily rig evaluation — 2026-07-24 — 5/5 passed

2 participants