Files
paseo-bot[bot]andDaye f232d23e9a fix(client): let SDK callers choose what a send does to an active turn (#5605)
PaseoAgentSendOptions was a hand-copied subset of the daemon client's
SendMessageOptions and dropped activeTurnBehavior, so
agents.ref(id).send(text, { activeTurnBehavior: "steer" }) and run() failed
to typecheck even though the value is forwarded to the daemon. The public
type is now the options type send() passes through, so the two cannot
drift again.

Closes #4555

Co-authored-by: paseo-bot[bot] <266920839+paseo-bot[bot]@users.noreply.github.com>
Co-authored-by: Daye <2077152374@qq.com>
2026-09-29 06:53:14 +02:00
..

Paseo Client SDK Examples

These examples use only the public SDK root:

import { createPaseoClient, type PaseoClient } from "@getpaseo/client";

Each example takes the daemon WebSocket URL as an argument. In worktree dev, read it from the portless banner or portless get daemon; for the desktop-managed daemon, use the URL for that daemon.

  • quickstart.ts runs one agent and prints its reply. It is a standalone script with the URL at the top; the rest export functions.
  • workspaces.ts covers creating a fresh workspace, opening by directory, refreshing, and archiving.
  • agents-and-providers.ts covers provider discovery, creating agents, and waiting for turns.
  • events-and-timeline.ts covers subscribing to workspace, agent, and timeline events, plus refetching a timeline page.
  • issue-to-agent.ts turns an issue record into a visible Paseo workspace and agent.
  • parallel-review.ts launches several reviewers concurrently and cleans them up.
  • provider-settings.ts covers provider settings that are currently daemon config-backed.

Provider profiles, provider env vars, custom binaries, and additional models are still raw daemon config behavior. The SDK exposes them through client.config.get() and client.config.patch() until first-class provider settings RPCs exist.