@usine/agents/pi

Classes

PiSdk

Opens a Pi session with the selected model and its repository tools.

Extends

• Context.ServiceClass

Properties

Service

readonly Service: object

The service’s operations: what yield* PiSdk returns.

start

readonly start: (options) => Promise<PiStartResult>

Parameters

Parameter	Type
options	PiStartOptions

Returns

Promise<PiStartResult>

Interfaces

PiSession

The subset of an in-process Pi session that the adapter uses.

Properties

abort

readonly abort: () => Promise<void>

Returns

Promise<void>

dispose

readonly dispose: () => void

Returns

void

messages

readonly messages: readonly AgentMessage[]

prompt

readonly prompt: (prompt) => Promise<void>

Parameters

Parameter	Type
prompt	string

Returns

Promise<void>

steer

readonly steer: (message) => Promise<void | "handled" | "queued">

Parameters

Parameter	Type
message	string

Returns

Promise<void | "handled" | "queued">

subscribe

readonly subscribe: (listener) => () => void

Parameters

Parameter	Type
listener	(event) => void

Returns

() => void

---

PiStartOptions

Properties

cwd

readonly cwd: string

environment

readonly environment: Option<Readonly<Record<string, string>>>

The complete environment of every command the session’s bash tool runs. None inherits this process’s environment, which suits preflight because it runs no repository command.

extensions

readonly extensions: readonly InlineExtension[]

model

readonly model: string & Brand<"ModelId">

signal

readonly signal: AbortSignal

thinkingLevel

readonly thinkingLevel: "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max"

Type Aliases

PiSessionEvent

PiSessionEvent = AgentSessionEvent

---

PiStartResult

PiStartResult = { _tag: "AuthenticationUnavailable"; model: ModelId; } | { _tag: "UnsupportedAuthentication"; authentication: Extract<PiAuthentication, { _tag: "OAuth"; }>; model: ModelId; } | { _tag: "UnknownModel"; } | { _tag: "UnsupportedEffort"; effort: Effort; model: ModelId; supported: ReadonlyArray<Effort>; } | { _tag: "Started"; model: ModelId; pool: PiPool; session: PiSession; }

Variables

piChildBackendLayer

const piChildBackendLayer: Layer.Layer<PiChildBackend, never, PiSdk>

Provides Pi coding sessions for tasks delegated by a parent.

---

piSdkLive

const piSdkLive: Layer.Layer<PiSdk, never, never>