[moonyue-w]

Summary

Align the existing Forward/Managed SDK contracts with the official QCA documentation reviewed on 2026-11-03. This adds typed Forward Session budgets and model overrides, approval evaluation details and Environment startup scripts; it fixes the language-specific gaps documented below. The README also documents startup timing, 64 KB / 5-minute constraints and failure events. No HTTP endpoints or version numbers change.

Forward event types now expose cumulative Credits and Outcome/status details, and shared model configuration exposes speed. Managed Memory version/redacted and Vault credentials are typed; Memory updated operations, list metadata, nested model types and legacy Thread usage are aligned where applicable.

Why

Current types omit fields in the documented API, and the approval result shape can be read incorrectly. This makes the existing endpoints usable through supported typed parameters and response fields.

Verification

Go 1.26.4: make lint, make build, make test, make docs-check, go build ./examples/..., changelog and release-tool tests passed. The complete SDK test run used a clean worktree at implementation commit 5c02339e559f4bb10ed32ffa907600e73896f06f; the follow-up commit changes only README documentation and its docs check passed.

• Relevant SDK, public type and package checks pass.
• Documentation and Unreleased changelog updated.
• Contract regression tests cover the changed wire fields and omission/null semantics.
• Cross-SDK parity and compatibility reviewed.
• No credentials or live configuration included.
• Account-backed integration and QA package acceptance: pending after merge; no live tests were run for this change.

The original checkout contains a pre-existing ignored tmp test with obsolete endpoint-count assertions. All tracked tests passed in the clean worktree; no tests were removed or relaxed.

Impact and migration

Compare Forward EvaluatedPermission and Managed nested model Effort directly as strings. Legacy Modified/Speed/Thread Usage remain deprecated compatibility entries.

Budget/model omission and null semantics, cumulative usage consumption, and migration details are in CHANGELOG.md. A pre-1.0 minor release is required for the incompatible type changes.

Contract sources

• https://docs.qoder.com/cloud-agents/api/forward/sessions/data-structure
• https://docs.qoder.com/cloud-agents/api/forward/sessions/update
• https://docs.qoder.com/cloud-agents/api/environments/schemas
• https://docs.qoder.com/cloud-agents/api/memory-stores/schemas