feat(provider): forward sessionOptions (systemPrompt, model, allowedTools, maxTurns) to runtime

[DaniAkash]

Summary

Upstream: openclaw/acpx#309 — the runtime PR this provider change consumes.

Surfaces sessionOptions on AcpxProviderSettings and threads it through ensureHandle into runtime.ensureSession(...). Lets AI-SDK consumers set a per-session systemPrompt (or model / allowedTools / maxTurns) on a fresh ACP session without bypassing the runtime.

const provider = createAcpxProvider({
  agent: 'claude-code',
  cwd: process.cwd(),
  sessionOptions: {
    systemPrompt: 'You are an expert Rust reviewer. Be terse.',
    // or { append: 'Also propose tests.' }
    // model, allowedTools, maxTurns also supported
  },
})

System prompts are applied on newSession; changing them later requires a new session (use a distinct sessionKey or close the prior record first). This matches the upstream runtime contract added in openclaw/acpx#309.

What changed

File	Change
package.json	Version 0.0.4 → 0.0.5. acpx peer-dep + dev-dep raised to >=0.8.0 (the upstream version that ships AcpRuntimeEnsureInput.sessionOptions + SessionAgentOptions + SystemPromptOption via openclaw/acpx#309).
src/types.ts	Add sessionOptions?: SessionAgentOptions to AcpxProviderSettings; re-export SessionAgentOptions + SystemPromptOption from acpx/runtime.
src/provider.ts	Forward this.settings.sessionOptions from ensureHandle into runtime.ensureSession(...) (one line).
src/index.ts	Re-export the two new types.
README.md	New ### System prompts snippet under "Persistent sessions" explaining string vs { append } forms and the "fresh session only" semantics.
test/unit/session-options.test.ts	NEW — three tests using MockAcpRuntime: (1) systemPrompt string flows through to ensureSession.sessionOptions, (2) { append } form + all four agent-option fields (model / allowedTools / maxTurns / systemPrompt) round-trip without mutation, (3) absent when not configured.

Test plan

• bun run lint clean.
• bun run typecheck clean (passes against the now-published acpx@0.8.0).
• bun run fallow clean.
• bun test — 266 pass / 24 skip / 0 fail across the monorepo (290 tests, 30 files; the three new tests are part of the 266).
• bun run build clean (ESM + .d.ts).

Coordination

Ships alongside two sibling provider features that all target 0.0.5:

• #17 — onPermissionRequest callback
• #19 — getModels() helper

Whichever lands first wins 0.0.5; the other two will need a follow-up bump (0.0.5 → 0.0.6 → 0.0.7) and a one-line package.json rebase to resolve the version conflict. All three are independent on the code side.

[Copilot]

Pull request overview

This PR adds support in acpx-ai-provider for passing per-session agent configuration (sessionOptions) through the provider into acpx/runtime.ensureSession(...), enabling callers to set systemPrompt (and related options) when creating a fresh ACP session.

Changes:

• Add sessionOptions?: SessionAgentOptions to AcpxProviderSettings and re-export related runtime types.
• Forward sessionOptions into runtime.ensureSession(...) during handle/session initialization.
• Document the feature and add unit tests validating the forwarded payload.

Reviewed changes

Copilot reviewed 6 out of 7 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
packages/acpx-ai-provider/test/unit/session-options.test.ts	Adds unit tests asserting sessionOptions forwarding behavior.
packages/acpx-ai-provider/src/types.ts	Adds sessionOptions to provider settings; re-exports SessionAgentOptions/SystemPromptOption.
packages/acpx-ai-provider/src/provider.ts	Threads sessionOptions into runtime.ensureSession(...).
packages/acpx-ai-provider/src/index.ts	Re-exports the new types from the package entrypoint.
packages/acpx-ai-provider/README.md	Documents system prompt / per-session options behavior and semantics.
packages/acpx-ai-provider/package.json	Bumps version and raises acpx dependency constraints.
bun.lock	Updates lockfile for new acpx version and workspace metadata.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.