Add the instruction display orchestrator and public API

[lorisleiva]

This PR completes the clear-signing display-text feature (sRFC 39) by assembling the value and render-mode layers into a public API. getInstructionDisplay parses a concrete instruction and resolves it into a human-readable display — an intent label, an interpolated sentence, and a structured fallback list — returning null when the instruction cannot be parsed; getInstructionDisplayFromParsedInstruction does the same from an already-parsed instruction. buildDisplayContext bridges a parsed instruction and its root into the single context threaded through the layer, resolving defined-type links by path against a linkable dictionary (correct even for links nested in types from other programs) and computing which members were surfaced through the provide/inject graph so whenInjected fields hide correctly when their value is presented elsewhere. @codama/dynamic-parsers now exports ParsedInstruction. The whole display layer is exported from the package, and a changeset records the minor bumps.

[changeset-bot]

🦋 Changeset detected

Latest commit: 15e0425

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 3 packages

Name	Type
@codama/dynamic-instructions	Minor
@codama/dynamic-parsers	Minor
@codama/dynamic-client	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[lorisleiva]

• Document the instruction display API in the README #1019
• Add the instruction display orchestrator and public API #1016 👈 (View in Graphite)
• Add interpolated-intent and fallback-list render modes #1015
• Add display value formatting and provide/inject resolution #1014
• Integrate @codama/spec@1.7.0 #1013
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[Copilot]

Pull request overview

This PR finalizes the clear-signing “display text” layer for dynamic instructions by adding an orchestrator that turns a concrete instruction (raw or already-parsed) into a human-readable presentation (intent label, optional interpolated sentence, and a structured fallback list). It also expands the display context to support correct cross-program defined-type link resolution and correct whenInjected hiding via a consumed-member computation.

Changes:

• Added a public display orchestration API: getInstructionDisplay and getInstructionDisplayFromParsedInstruction, plus buildDisplayContext.
• Implemented consumedMemberNames computation to make whenInjected hiding depend on resolved provide/inject usage (online vs offline behavior).
• Exported ParsedInstruction from @codama/dynamic-parsers and exported the full display layer from @codama/dynamic-instructions (with changeset + dependency updates).

Reviewed changes

Copilot reviewed 21 out of 22 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
pnpm-lock.yaml	Adds workspace link for @codama/dynamic-parsers dependency usage.
packages/dynamic-parsers/src/parsers.ts	Exports ParsedInstruction(+accounts) types for downstream API usage.
packages/dynamic-instructions/package.json	Adds @codama/dynamic-parsers dependency required by the new API.
packages/dynamic-instructions/src/index.ts	Re-exports the full display layer as part of the public package API.
packages/dynamic-instructions/src/display/index.ts	Adds new exports for orchestrator/context and consumed-member resolution.
packages/dynamic-instructions/src/display/types.ts	Introduces InstructionDisplay, options, consumedMemberNames, and path-based defined-type resolution.
packages/dynamic-instructions/src/display/get-instruction-display.ts	New public API entrypoints for generating instruction display output.
packages/dynamic-instructions/src/display/build-display-context.ts	New context builder bridging parsed instruction + root, including link resolution + consumed-member computation.
packages/dynamic-instructions/src/display/resolve-consumed-members.ts	New logic to compute which members were surfaced through provide/inject (for whenInjected).
packages/dynamic-instructions/src/display/list-fallback.ts	Switches from instruction to instructionPath and from provides.has to consumedMemberNames.has for hiding.
packages/dynamic-instructions/src/display/interpolate-intent.ts	Switches from instruction to instructionPath and passes correct owner paths to formatting.
packages/dynamic-instructions/src/display/format-argument-value.ts	Adds owner-path-aware link following so nested links resolve against the correct program.
packages/dynamic-instructions/src/display/format-value.ts	Adjusts context typing to allow pre-consumed-member context usage.
packages/dynamic-instructions/src/display/resolve-injected-value.ts	Adjusts context typing to allow pre-consumed-member context usage.
packages/dynamic-instructions/test/test-utils.ts	Updates test helpers for instructionPath, consumed-member plumbing, and new resolver/fetch helpers.
packages/dynamic-instructions/test/display/resolve-consumed-members.test.ts	New test coverage for consumed-member computation across online/offline cases.
packages/dynamic-instructions/test/display/get-instruction-display.test.ts	New end-to-end tests for the orchestrator across presentation tiers + cross-program link resolution.
packages/dynamic-instructions/test/display/build-display-context.test.ts	New tests for context assembly (data/accounts/provides/link resolution/options).
packages/dynamic-instructions/test/display/list-fallback.test.ts	Updates tests to use path-based context + consumed-member hiding semantics.
packages/dynamic-instructions/test/display/interpolate-intent.test.ts	Updates tests to use path-based context.
packages/dynamic-instructions/test/display/format-argument-value.test.ts	Updates tests for new formatArgumentValue(type, ownerPath, value, ctx) signature and resolver helper.
.changeset/every-bikes-rhyme.md	Records minor bumps + feature description for the new clear-signing display API.

Files not reviewed (1)

• pnpm-lock.yaml: Generated file

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[mikhd]

Do we want to add new display methods to README.md?

[lorisleiva]

Merge activity

• Jul 9, 2:00 PM UTC: A user started a stack merge that includes this pull request via Graphite.
• Jul 9, 2:07 PM UTC: Graphite rebased this pull request as part of a merge.
• Jul 9, 2:07 PM UTC: @lorisleiva merged this pull request with Graphite.