Index of every page on this site: llms.txt
All skills
vercel avatar

/update-harness-dependencies

@a8f0e9d official
by vercelvercel/ai28k stars
5,666
Run it yourself

Update the primary SDK dependencies of harness packages. Use when asked to update the harness SDKs or harness adapter dependencies.

  • 1 file
  • 6.7 KB
  • Updated 2 weeks ago
  • GitHub
Use this Skill: https://skilld.dev/gh/vercel/ai/update-harness-dependencies

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈40 tokens for metadata: the name and description. ≈1.6k when used: this file.

Description uses 2.0% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈161 characters, or 2.0%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Update the harness packages

The harness adapters are all the packages/harness-* packages. They each rely on one or more third-party packages for the respective harness's primary SDK. It is crucial to keep those dependencies up to date.

Below you find the instructions on how to update those packages to their latest versions, while adhering to the minimum release age defined in pnpm-workspace.yaml.

Update the harness dependency packages

Run the following commands to update each harness's primary SDK packages.

  • For bridge harnesses (e.g. Claude Code), this will update the packages in devDependencies, while the actual package versions used as dependencies are only relevant to the harness's bridge itself.
  • For non-bridge harnesses (e.g. Pi), this will update the packages in dependencies.

Run these commands exactly as below:

# ACP
pnpm --filter harness-acp update @agentclientprotocol/sdk @modelcontextprotocol/sdk --latest --lockfile-only
# Claude Code
pnpm --filter harness-claude-code update @anthropic-ai/claude-agent-sdk @modelcontextprotocol/sdk --latest --lockfile-only
# Cline
pnpm --filter harness-cline update @cline/agents @cline/core --latest --lockfile-only
# Codex
pnpm --filter harness-codex update @openai/codex --latest --lockfile-only
# Deep Agents
pnpm --filter harness-deepagents update @langchain/anthropic @langchain/core @langchain/langgraph deepagents langchain langsmith --latest --lockfile-only
# fx
pnpm --filter harness-fx update libfx --latest --lockfile-only
# GitHub Copilot
pnpm --filter harness-github-copilot update @github/copilot --latest --lockfile-only
# Grok Build
pnpm --filter harness-grok-build update @xai-official/grok --latest --lockfile-only
# OpenCode
pnpm --filter harness-opencode update @opencode-ai/sdk --latest --lockfile-only
# Pi
pnpm --filter harness-pi update @earendil-works/pi-coding-agent --latest --lockfile-only

For the bridge dependencies of bridge harnesses, you must additionally run the following commands. It is important to specify the config.minimumReleaseAge flag in accordance with what pnpm-workspace.yaml defines, because for these commands the --ignore-workspace flag is needed.

Run these commands exactly as below:

# ACP
pnpm --dir packages/harness-acp/src/v1/bridge update @agentclientprotocol/sdk @modelcontextprotocol/sdk --latest --ignore-workspace --config.minimumReleaseAge=4320
# Claude Code
pnpm --dir packages/harness-claude-code/src/bridge update @anthropic-ai/claude-agent-sdk @anthropic-ai/claude-code @modelcontextprotocol/sdk --latest --ignore-workspace --config.minimumReleaseAge=4320
# Codex
pnpm --dir packages/harness-codex/src/bridge update @openai/codex --latest --ignore-workspace --config.minimumReleaseAge=4320
# Deep Agents
pnpm --dir packages/harness-deepagents/src/bridge update @langchain/anthropic @langchain/core @langchain/langgraph deepagents langchain langsmith --latest --ignore-workspace --config.minimumReleaseAge=4320
# GitHub Copilot
pnpm --dir packages/harness-github-copilot/src/bridge update @agentclientprotocol/sdk @github/copilot @modelcontextprotocol/sdk --latest --ignore-workspace --config.minimumReleaseAge=4320
# Grok Build
pnpm --dir packages/harness-grok-build/src/bridge update @agentclientprotocol/sdk @modelcontextprotocol/sdk @xai-official/grok --latest --ignore-workspace --config.minimumReleaseAge=4320
# OpenCode
pnpm --dir packages/harness-opencode/src/bridge update @opencode-ai/sdk opencode-ai --latest --ignore-workspace --config.minimumReleaseAge=4320

The following harness adapter uses an unversioned installer script instead of an NPM package for its CLI and therefore can be ignored:

  • packages/harness-cursor
Example dependencies

Check the package.json files in examples/harness-e2e-next and examples/harness-e2e-tui for any of the above SDKs they depend on. Those dependencies need to be updated to match the exact version used in the packages as well.

Update ACP and MCP SDKs everywhere

Find every harness package and bridge manifest that declares either SDK:

rg -n '"(@agentclientprotocol/sdk|@modelcontextprotocol/sdk)"' packages/harness-* --glob 'package.json'

For each matching workspace package manifest, update its declared SDKs with pnpm --filter. Replace the placeholders with the harness workspace name and the SDK package names found in that manifest:

pnpm --filter <harness-name> update <sdk-package>... --latest --lockfile-only

# Example
pnpm --filter harness-acp update @agentclientprotocol/sdk @modelcontextprotocol/sdk --latest --lockfile-only

For each matching bridge manifest, run pnpm --dir in the directory containing that manifest:

pnpm --dir <bridge-directory> update <sdk-package>... --latest --ignore-workspace --config.minimumReleaseAge=4320

# Example
pnpm --dir packages/harness-acp/src/v1/bridge update @agentclientprotocol/sdk @modelcontextprotocol/sdk --latest --ignore-workspace --config.minimumReleaseAge=4320

Align ACP npm-locked bridge manifests

ACP adapters that use an npm-locked source install their own bridge manifest instead of the harness-acp bridge manifest. packages/harness-acp/src/v1/bridge/package.json is the authoritative source for the bridge dependencies, and every npm-locked bridge manifest must declare each of its dependencies at the exact same version:

  • packages/harness-github-copilot/src/bridge/package.json
  • packages/harness-grok-build/src/bridge/package.json
  • examples/ai-functions/src/lib/codex-acp-bridge/package.json
  • examples/harness-e2e-next/agent/harness/acp-codex/bridge/package.json

After updating the harness-acp bridge manifest, copy its dependency versions into each of these manifests and regenerate their lockfiles:

pnpm --dir packages/harness-github-copilot/src/bridge install --lockfile-only --ignore-workspace --config.minimumReleaseAge=4320
pnpm --dir packages/harness-grok-build/src/bridge install --lockfile-only --ignore-workspace --config.minimumReleaseAge=4320
pnpm --dir examples/ai-functions/src/lib/codex-acp-bridge install --lockfile-only --ignore-workspace --config.minimumReleaseAge=4320
pnpm --dir examples/harness-e2e-next/agent/harness/acp-codex/bridge install --lockfile-only --ignore-workspace --config.minimumReleaseAge=4320

Verification

Run the verification script to ensure all relevant dependency versions are aligned:

./tools/verify-harness-adapter-deps.mjs

If this script shows errors, you must address them, then rerun the verification script until it passes.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No third-party reports yet.

Signed by skilld at a8f0e9d. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 2 weeks ago
metadata
{
  "internal": true
}

README badge

README badge for vercel/ai/update-harness-dependencies