PTY access through the OpenAI adapter

export DECLAW_API_KEY="your-api-key"
export DECLAW_DOMAIN="your-declaw-instance.example.com:8080"

pip install "declaw[openai-agents]"

from declaw import PtySize
from declaw.openai import DeclawSandboxClient, DeclawSandboxClientOptions

client = DeclawSandboxClient()
session = await client.create(options=DeclawSandboxClientOptions(
    template="base",
    timeout=120,
    envs={"PTY_DEMO": "declaw-openai-pty"},
))

pty = session._inner._sbx.pty
buf = bytearray()
handle = await pty.create(on_data=lambda c: buf.extend(c), timeout=30)

# 1. Env passthrough
await handle.send_stdin(b"printenv PTY_DEMO\n")

# 2. Shell state persists across sends
await handle.send_stdin(b"X=42; echo X=$X\n")
await handle.send_stdin(b"echo still X=$X\n")

# 3. ANSI progress bar (garbled without a real PTY)
await handle.send_stdin(
    b"for i in $(seq 1 20); do "
    b"printf '\\r[%-20s] %d%%' $(printf '#%.0s' $(seq 1 $i)) $((i*5)); "
    b"sleep 0.05; done; echo\n"
)

# 4. Resize
await handle.resize(PtySize(cols=100, rows=30))
await handle.send_stdin(b"stty size\n")

await handle.kill()
await client.delete(session=session)

export DECLAW_API_KEY="your-api-key"
export DECLAW_DOMAIN="api.declaw.ai"
python cookbook/examples/openai-agents-pty/main.py

pty pid=7

== PTY output ==
declaw-openai-pty
=== state ===
X=42
still X=42
=== progress ===
[####################] 100%
=== size ===
30 100