> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cosmon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# One-shot run

> Run a prompt and print the final answer.

The simplest call: `client.run(...)` starts a one-shot run and returns a `Run`;
`.text()` drives it to completion and returns the transcript — the answer with
each tool step inline.

```python theme={null}
from cosmon_agent_sdk import Client

with Client() as client:
    answer = client.run(
        "What is the peak von Mises stress in bracket.sldprt?",
        agent="solidworks",
    ).text()
    print(answer)
```

Pass `live=True` to `.text()` to watch the run print while you wait; the returned
string stays the authoritative version.

<Card title="Guide: run(...).text()" icon="book-open" href="/sdk/guide">
  Transcripts, live output, and when to reach for a session instead.
</Card>
