Skip to content

Commit ee82f82

Browse files
committed
Reword new doc passages to avoid dash asides
1 parent 59f4c8d commit ee82f82

3 files changed

Lines changed: 6 additions & 6 deletions

File tree

docs/advanced/multi-round-trip.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ That's the whole protocol. Every leg is an ordinary request from the client to t
1919

2020
## The server side
2121

22-
On `@mcp.tool()` you rarely build this by hand: declare a dependency that asks the user and the SDK returns the `InputRequiredResult` for you - that form is the **[Dependencies](../tutorial/dependencies.md)** tutorial. The two forms don't mix: a call has one `input_responses`/`request_state` channel, so a tool that uses `Resolve(...)` parameters cannot also return `InputRequiredResult` from its body - a declared `InputRequiredResult` return is rejected at registration (`InvalidSignature`), and an undeclared one fails the call at runtime. The manual form is the **low-level** `Server`, whose `on_call_tool` handler is allowed to return either result type:
22+
On `@mcp.tool()` you rarely build this by hand: declare a dependency that asks the user and the SDK returns the `InputRequiredResult` for you - that form is the **[Dependencies](../tutorial/dependencies.md)** tutorial. The two forms don't mix: a call has one `input_responses`/`request_state` channel, so a tool that uses `Resolve(...)` parameters cannot also return `InputRequiredResult` from its body. A declared `InputRequiredResult` return is rejected at registration (`InvalidSignature`), and an undeclared one fails the call at runtime. The manual form is the **low-level** `Server`, whose `on_call_tool` handler is allowed to return either result type:
2323

2424
```python title="server.py" hl_lines="44-47"
2525
--8<-- "docs_src/mrtr/tutorial001.py"

docs/tutorial/dependencies.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -126,10 +126,10 @@ That's the right default for a precondition: no answer, no order. When declining
126126
multi-round-trip form any resolver may run again whenever the call resumes after a question,
127127
so code before a `return Elicit(...)` runs on each of those rounds; the recorded answer then
128128
satisfies the repeated question without prompting the user again. A recorded answer is only
129-
ever consulted when the resolver asks - a resolver that answers *without* asking, like
129+
ever consulted when the resolver asks; a resolver that answers *without* asking, like
130130
`check_stock`, always supplies its own computed value. Because each answer is matched back to
131131
its question, an eliciting resolver must derive its question deterministically from the
132-
tool's arguments and earlier answers - a per-call generated value (a `default_factory` id, a
132+
tool's arguments and earlier answers. A per-call generated value (a `default_factory` id, a
133133
timestamp) is re-derived on each round and must not appear in a question the answer is meant
134134
to bind to.
135135

examples/stories/refund_desk/README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -62,9 +62,9 @@ uv run python -m stories.refund_desk.client --http
6262
within a round each resolver runs at most once, keyed by function identity.
6363
Across 2026 rounds only *elicited* outcomes persist (in `requestState`); any
6464
resolver's body may run again on each round the call passes through. A
65-
recorded answer is consulted only when the resolver asks its question again
66-
it satisfies the question without re-prompting the user, and never stands in
67-
for a value the resolver computes itself.
65+
recorded answer is consulted only when the resolver asks its question again:
66+
it satisfies the question without re-prompting the user, and it never stands
67+
in for a value the resolver computes itself.
6868
An answer is matched back to its question when the call resumes, so an
6969
eliciting resolver must derive its question deterministically from the
7070
tool's arguments and earlier answers; a per-call generated value (a

0 commit comments

Comments
 (0)