update-golden

star 4

Updates golden test files from the Python SDK for cross-SDK compatibility verification.

rebornix By rebornix schedule Updated 2/1/2026

name: update-golden description: Updates golden test files from the Python SDK for cross-SDK compatibility verification.

Update Golden Tests Skill

Updates golden test files from the Python SDK.

Trigger

User says: "/update-golden" or "sync golden tests"

Process

  1. Fetch latest golden files from: https://github.com/agentclientprotocol/python-sdk/tree/main/tests/golden

    Or if a local Python SDK exists: /Users/lvpeng/Code/exp/python-sdk/tests/golden/

  2. Copy JSON files to Tests/ACPTests/Golden/

  3. Verify Swift types can decode all golden files:

    • Create or update parsing tests
    • Report any decoding failures
  4. Update tests if needed:

    • Add new test cases for new golden files
    • Update existing tests for changed schemas

Golden File Categories

Category Files
Initialize initialize_request.json, initialize_response.json
Session new_session_*.json, session_update_*.json
Content content_*.json
Permissions request_permission_*.json, permission_outcome_*.json
Tool Content tool_content_*.json
Filesystem fs_*.json

Verification

After copying, run:

swift test --filter Golden

Or run all tests:

swift test

Notes

  • Golden files represent canonical JSON examples
  • Used for cross-SDK compatibility verification
  • Should produce identical wire format across SDKs
  • If a golden file fails to decode, investigate whether:
    1. The Swift type needs updating
    2. The golden file has an error
    3. There's a protocol version mismatch
Install via CLI
npx skills add https://github.com/rebornix/acp-swift-sdk --skill update-golden
Repository Details
star Stars 4
call_split Forks 0
navigation Branch main
article Path SKILL.md
More from Creator