feat: Task-specific model switching with auto-restore

[wca4a]

Summary

Adds task-specific model switching capability that automatically saves and restores the original model after task completion.

Features

1. Model Switching Script (scripts/model.ts)

• Switch between Claude models: sonnet, opus, haiku, gemini, gemini-flash
• Automatically saves original model before switching
• Restores original model after task completion
• State tracking via ~/.clawdbot/.model-state.json
• Commands:
  • model.ts [model] - Switch model (saves original)
  • model.ts restore - Restore original model
  • model.ts state - Check if override is active

2. Authorization

• Restricted to authorized ships via SKILL.md metadata
• Configure allowed ships: authorization.ships: ["~your-ship"]
• Prevents unauthorized model changes

3. Workflow

User (authorized): "Use opus to analyze this code"
  ↓
Bot switches to opus (saves original: sonnet)
  ↓
Bot completes analysis with opus
  ↓
Bot restores to sonnet
  ↓
User sees results from opus, bot returns to default

Usage

For Bot Operators:

Configure authorized ships in SKILL.md:

authorization:
  model: ships-only
  ships: ["~malmur-halmex", "~trusted-ship"]

For Users:

Request model for specific task:

• "Use opus for this analysis"
• "Switch to haiku for this quick task"
• "Can you use gemini to generate this?"

Bot automatically handles save/restore cycle.

Implementation Details

• Model state persisted to ~/.clawdbot/.model-state.json
• Original model saved with timestamp
• Restoration cleans up state file
• Gateway restart required for changes to take effect
• Aliases resolve to full model names (e.g., opus → anthropic/claude-opus-4-5)

Testing

# Check current model
npx ts-node scripts/model.ts

# Switch to opus (saves original)
npx ts-node scripts/model.ts opus

# Check state
npx ts-node scripts/model.ts state

# Restore original
npx ts-node scripts/model.ts restore

Documentation

Updated SKILL.md with:

• Authorization section explaining ship restrictions
• Model switching commands and workflow
• Task-specific usage examples
• Notes on gateway restart requirements

🤖 Generated with Claude Sonnet 4.5