anthropic-skills/skills/claude-api/shared
Lance Martin 1f630fdf92
Update claude-api skill: Managed Agents July launch wave, partner pricing, tool-runner corrections (#1463)
Syncs the claude-api skill with the current upstream source.

## Managed Agents — five new features

- `effort` on the agent's `model` object (a level string or `{"type": "<level>"}`).
  It is agent-configuration only: setting it in a per-session `model` override is
  silently ignored.
- Optional `version` on agent update, for optimistic concurrency. Omit it for
  last-write-wins.
- `initial_events` on session create, collapsing create plus first send into one
  call. Validation is all-or-nothing and only `user.message` and
  `user.define_outcome` are accepted.
- Environment and memory-store webhooks: four `environment.*` events and three
  `memory_store.*` events.
- Event deltas on per-thread streams. Previews are thread-scoped, so a child
  thread's previews never reach the session-level stream.

## Corrections to behavior the skill already documented

- Tool output offload triggers at 100,000 characters (~25k tokens), not 100K
  tokens, and covers built-in tools rather than MCP alone.
- `system.message` works on four models, checks only the primary model, appends
  system context instead of replacing the prompt, and is accepted during a
  `requires_action` idle when it trails a tool result in the same request.
- Vault-to-MCP credential matching is normalized (scheme and host lowercased,
  default ports and trailing slashes stripped), not byte-exact.
- Multiagent depth greater than 1 is a validation error, not silently ignored.
- Outcome `interrupted` fires even when evaluation never started, and then
  carries an empty-string `outcome_evaluation_start_id`.
- Deployment jitter is 15% of the run interval, floor 5s, cap 9 minutes.
- Webhooks retry three times with jittered 5-120s backoff, then drop silently.
  Auto-disable is duration-based with three named triggers.
- `session.status_terminated` means completion or error.
- `agent.thinking` is a progress signal and carries no thinking content.
- `processed_at` is already populated on first sighting for
  `user.define_outcome`, `user.custom_tool_result`, and `user.tool_result`.
- Session creation does not provision the sandbox.
- Skill `version` applies to Anthropic-authored skills too.
- Console-created vault credentials are header-injection only, and vault
  environment-variable substitution skips secrets in URL paths.
- Console trace URLs need the real workspace ID when the API key is not in the
  Default workspace.

## Elsewhere in the skill

- Note partner pricing under the first-party price table: Microsoft Foundry
  bills at standard API rates, while Amazon Bedrock and Vertex AI are
  partner-operated with separate pricing.
- Correct the tool-runner human-in-the-loop guidance, which previously pointed
  readers at the manual loop for approval gates the runner's per-turn hooks
  already cover.
- Repoint links away from the retired documentation hosts.
- Dedupe eagerly loaded SKILL.md content that the per-section files already
  cover.
2026-07-22 14:20:09 -04:00
..
agent-design.md Update claude-api skill: Claude Sonnet 5 and Managed Agents July updates (#1373) 2026-07-01 14:11:23 -04:00
anthropic-cli.md Update claude-api skill: Claude Sonnet 5 and Managed Agents July updates (#1373) 2026-07-01 14:11:23 -04:00
claude-platform-on-aws.md Update claude-api skill: Claude Sonnet 5 and Managed Agents July updates (#1373) 2026-07-01 14:11:23 -04:00
error-codes.md Update claude-api skill: per-SDK doc split, code_execution_20260521, platform-availability, onboarding streamline (#1363) 2026-06-27 12:07:56 -04:00
live-sources.md Update claude-api skill: Managed Agents July launch wave, partner pricing, tool-runner corrections (#1463) 2026-07-22 14:20:09 -04:00
managed-agents-api-reference.md Update claude-api skill: Managed Agents July launch wave, partner pricing, tool-runner corrections (#1463) 2026-07-22 14:20:09 -04:00
managed-agents-client-patterns.md Update claude-api skill: Managed Agents July launch wave, partner pricing, tool-runner corrections (#1463) 2026-07-22 14:20:09 -04:00
managed-agents-core.md Update claude-api skill: Managed Agents July launch wave, partner pricing, tool-runner corrections (#1463) 2026-07-22 14:20:09 -04:00
managed-agents-environments.md Update claude-api skill: Managed Agents July launch wave, partner pricing, tool-runner corrections (#1463) 2026-07-22 14:20:09 -04:00
managed-agents-events.md Update claude-api skill: Managed Agents July launch wave, partner pricing, tool-runner corrections (#1463) 2026-07-22 14:20:09 -04:00
managed-agents-memory.md Update claude-api skill: Managed Agents July launch wave, partner pricing, tool-runner corrections (#1463) 2026-07-22 14:20:09 -04:00
managed-agents-multiagent.md Update claude-api skill: Managed Agents July launch wave, partner pricing, tool-runner corrections (#1463) 2026-07-22 14:20:09 -04:00
managed-agents-onboarding.md Update claude-api skill: Managed Agents July launch wave, partner pricing, tool-runner corrections (#1463) 2026-07-22 14:20:09 -04:00
managed-agents-outcomes.md Update claude-api skill: Managed Agents July launch wave, partner pricing, tool-runner corrections (#1463) 2026-07-22 14:20:09 -04:00
managed-agents-overview.md Update claude-api skill: Managed Agents July launch wave, partner pricing, tool-runner corrections (#1463) 2026-07-22 14:20:09 -04:00
managed-agents-scheduled-deployments.md Update claude-api skill: Managed Agents July launch wave, partner pricing, tool-runner corrections (#1463) 2026-07-22 14:20:09 -04:00
managed-agents-self-hosted-sandboxes.md Update claude-api skill: scheduled deployments, vault env-var credentials, system.message events (#1297) 2026-06-09 16:35:16 -04:00
managed-agents-tools.md Update claude-api skill: Managed Agents July launch wave, partner pricing, tool-runner corrections (#1463) 2026-07-22 14:20:09 -04:00
managed-agents-webhooks.md Update claude-api skill: Managed Agents July launch wave, partner pricing, tool-runner corrections (#1463) 2026-07-22 14:20:09 -04:00
model-migration.md Update claude-api skill: Claude Sonnet 5 and Managed Agents July updates (#1373) 2026-07-01 14:11:23 -04:00
models.md Update claude-api skill: Claude Sonnet 5 and Managed Agents July updates (#1373) 2026-07-01 14:11:23 -04:00
platform-availability.md Update claude-api skill: per-SDK doc split, code_execution_20260521, platform-availability, onboarding streamline (#1363) 2026-06-27 12:07:56 -04:00
prompt-caching.md Update claude-api skill: per-SDK doc split, code_execution_20260521, platform-availability, onboarding streamline (#1363) 2026-06-27 12:07:56 -04:00
token-counting.md Update claude-api skill: auth, cloud providers, Managed Agents fixes, token counting (#1276) 2026-06-07 16:21:33 -04:00
tool-use-concepts.md Update claude-api skill: Managed Agents July launch wave, partner pricing, tool-runner corrections (#1463) 2026-07-22 14:20:09 -04:00