pb-new-agent-session

pb-new-agent-session — spawn a worker and drive it to a result

Goal

One delegated task, one session: pick the adapter and model, spawn the worker with a self-contained brief, wait for its turn to end, read and verify the result, then kill the session so the tree stays clean.

Prerequisites (reference by name, not re-explained here): ap-spawn-agent, ap-read-output, ap-wait-fanin, ap-lifecycle, ap-models-auth, ap-adapters. The family map is the agentproto skill; the cheap-model picking guidance lives in the cheap-coders group.

Steps

1. Pick the adapter and model

• Cheap bulk work: hermes + z-ai/glm-5.3-flash, billed through the openrouter-env access profile. Note: hermes has NO built-in file/shell tools.
• Work that must edit files or run commands natively: claude-code (Read, Write, Bash, Edit are built in — no gateway mount needed).
• Check what is installed before choosing (adapter listing from ap-adapters); model eligibility and access profiles go to ap-models-auth.

2. Take the event cursor BEFORE spawning

Grab a cursor first so the spawn event cannot slip past your wait:

session_events_poll({})

Use the returned nextCursor in every later session_monitor call. Events emitted before this first poll are returned immediately with since, so the ordering is race-free.

3. Spawn with a self-contained brief

The child knows nothing about your conversation — put paths, constraints, deliverable, and done-criteria in the prompt:

agent_start({
  adapter: 'hermes',
  model: 'z-ai/glm-5.3-flash',
  cwd: '<ABSOLUTE host path>',
  label: 'worker-audit',
  access: { profileRef: 'openrouter-env' },
  mcpServers: [{ name: 'agentproto', transport: 'http', ref: 'http://127.0.0.1:18790/mcp' }],
  prompt: '<self-contained brief: goal, exact file paths, constraints>'
})

For claude-code, drop mcpServers (native tools) and keep the rest. The call returns the session id — keep it with the label.