Summary

PingResponse.from_dict raises a ValueError on macOS (arm64) when the bundled Copilot CLI binary (1.0.51) returns an ISO-8601 string for the timestamp field in the ping JSON-RPC response, because the SDK unconditionally parses it with int(timestamp).

Environment

Steps to Reproduce

1. Install the SDK on macOS arm64:

   pip install github-copilot-sdk==0.3.0

2. Start the bundled CLI server and connect a CopilotClient using ExternalServerConfig — it will call client.start() which internally calls ping().

Error

ValueError: invalid literal for int() with base 10: '2026-05-22T17:50:31.689Z'

Points to copilot/client.py line 204:

return PingResponse(str(message), int(timestamp), int(protocolVersion))

Root Cause

The macOS arm64 wheel of github-copilot-sdk 0.3.0 bundles CLI binary 1.0.51. This binary now returns the ping response's timestamp as an ISO-8601 string instead of a Unix millisecond integer. int(timestamp) raises ValueError on an ISO-8601 string.

The Linux/amd64 wheel is unaffected — it bundles a different binary build that still returns an integer, so no crash occurs there.

Suggested Fix

def _parse_timestamp(value: object) -> int:
    try:
        return int(value)  # type: ignore[arg-type]
    except (ValueError, TypeError):
        from datetime import datetime, timezone
        dt = datetime.fromisoformat(str(value).replace("Z", "+00:00"))
        return int(dt.timestamp() * 1000)

# In PingResponse.from_dict:
return PingResponse(str(message), _parse_timestamp(timestamp), int(protocolVersion))

Note: timestamp is only consumed by _verify_protocol_version which only reads protocolVersion, so a lenient parse here is completely safe.