Tune code mode tool descriptions

[RhysSullivan]

Summary

• reorganizes the execute tool description into discovery, result, output, and runtime guidance
• clarifies persistent cell descriptions so agents repeat wait_cell({ cellId, after: cursor }) until terminal status
• adds coverage for the model-facing description text exposed over MCP

Validation

• bun run test src/description.test.ts in packages/core/execution
• bun run test src/tool-server.test.ts in packages/hosts/mcp
• bun run typecheck in packages/core/execution
• bun run typecheck in packages/hosts/mcp
• bun run format:check
• E2E_SELFHOST_URL=http://100.72.55.77:45974 ../node_modules/.bin/vitest run --project selfhost scenarios/codemode-persistent-cells.test.ts in e2e

Manual Probe

Ran real OpenCode model probes against the live selfhost MCP server. Kimi, DeepSeek, and Nemotron completed the execute_cell -> repeated wait_cell lifecycle from a natural prompt. Qwen selected execute_cell but stalled before waiting.

Builds on #1072.

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	executor-marketing	27a1a9a	Commit Preview URL Branch Preview URL	Jun 23 2026, 05:13 AM

[github-actions]

Cloudflare preview

Console	https://executor-preview-pr-1090.executor-e2e.workers.dev
MCP	https://executor-preview-pr-1090.executor-e2e.workers.dev/mcp
Deployed commit	27a1a9a

Sign-in is Cloudflare Access (one-time PIN to an allowed email). The preview has its own database and encryption key; it is destroyed when this PR closes.

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Updated (UTC)
✅ Deployment successful! View logs	executor-cloud	27a1a9a	Jun 23 2026, 05:15 AM

[pkg-pr-new]

Open in StackBlitz

@executor-js/cli

npm i https://pkg.pr.new/@executor-js/cli@1090

@executor-js/config

npm i https://pkg.pr.new/@executor-js/config@1090

@executor-js/execution

npm i https://pkg.pr.new/@executor-js/execution@1090

@executor-js/sdk

npm i https://pkg.pr.new/@executor-js/sdk@1090

@executor-js/codemode-core

npm i https://pkg.pr.new/@executor-js/codemode-core@1090

@executor-js/runtime-quickjs

npm i https://pkg.pr.new/@executor-js/runtime-quickjs@1090

@executor-js/plugin-file-secrets

npm i https://pkg.pr.new/@executor-js/plugin-file-secrets@1090

@executor-js/plugin-graphql

npm i https://pkg.pr.new/@executor-js/plugin-graphql@1090

@executor-js/plugin-keychain

npm i https://pkg.pr.new/@executor-js/plugin-keychain@1090

@executor-js/plugin-mcp

npm i https://pkg.pr.new/@executor-js/plugin-mcp@1090

@executor-js/plugin-onepassword

npm i https://pkg.pr.new/@executor-js/plugin-onepassword@1090

@executor-js/plugin-openapi

npm i https://pkg.pr.new/@executor-js/plugin-openapi@1090

executor

npm i https://pkg.pr.new/executor@1090

commit: 27a1a9a