gluon-agent: Skill for Claude Code

Upgrade Claude Agent SDK

Overview

Perform a structured upgrade of the claude-agent-sdk Python package in this project. Review upstream changes, assess integration impact, expose new features to users where appropriate, update documentation, and ship the result on a clean feature branch.

Workflow

Execute these phases in order. Do not skip phases — each validates the previous.

Phase 1: Discover SDK Changes

1. Check current version

   uv run python -c "import claude_agent_sdk; print(claude_agent_sdk.__version__)"
   grep 'claude-agent-sdk' pyproject.toml
   

2. Fetch latest SDK release info from https://github.com/anthropics/claude-agent-sdk-python

   Use gh CLI or web tools to review:

   • Release notes / changelog
   • New/changed exports in claude_agent_sdk and claude_agent_sdk.types
   • New fields on ClaudeAgentOptions (the primary integration surface)

3. Inspect SDK types programmatically

   # After installing the new version
   uv run python -c "
   import dataclasses, claude_agent_sdk
   for f in dataclasses.fields(claude_agent_sdk.ClaudeAgentOptions):
       print(f'{f.name}: {f.type}')
   "
   

4. Produce a change summary listing:

   • New ClaudeAgentOptions fields (type, default, purpose)
   • Deprecated or removed fields
   • New exported types/classes
   • Breaking changes to existing APIs
   • CLI flag changes (run CLAUDECODE= claude --help to check)

Phase 2: Assess Integration Impact

Read the integration map at references/integration-map.md for the full data flow.

For each SDK change, determine:

1. Does it affect existing integration? Check if any current code in agent.py uses deprecated/changed APIs. Fix these first.

2. Is it a new feature? Classify it:

   • Global preference → Settings page + store.get_setting()
   • Per-task option → TASK_PROFILES + resolve_task_options() + Advanced Options UI
   • SDK-only internal → agent.py only
   • Informational → README/docs only