feat(tool runner): add context parameter to tool run functions by karpetrosyan · Pull Request #877 · anthropics/anthropic-sdk-typescript

karpetrosyan · 2026-01-13T07:05:24Z

Add context parameter to tool run functions

Adds an optional meta parameter to tool run functions that provides access to tool invocation metadata.

Usage

const tool = betaTool({
  name: 'calculator',
  input_schema: { /* ... */ },
  description: 'Perform arithmetic',
  run: (input, meta) => {
    console.log(`Tool invocation ID: ${meta?.toolUseBlock.id}`);
    return String(input.a + input.b);
  },
});

fix(client): don't strip path from filename for skills endpoint

docs: update README with Claude branding - Add Claude sparkle logo to header - Rename to "Claude SDK for TypeScript" - Use "Claude API" terminology instead of "Anthropic API" - Link to TypeScript SDK docs at platform.claude.com - Simplify and consolidate documentation sections Co-Authored-By: Claude <noreply@anthropic.com>

* "Claude PR Assistant workflow" * "Claude Code Review workflow"

Co-authored-by: Vibeke Tengroth <vibeketengroth@gmail.com> Co-authored-by: Packy Gallagher <packy@anthropic.com>

felixfbecker · 2026-01-13T07:22:10Z

Thank you for the PR! Could you share the background/motivation/use case for this change?

karpetrosyan · 2026-01-14T08:52:09Z

@RobertCraigie would you be able to take a look?

…n output_format

@deprecated

* feat(api): update via SDK Studio * feat(api): update via SDK Studio * codegen metadata * feat: migrate output_format to output_config.format for structured outputs - Update beta header from structured-outputs-2025-11-13 to structured-outputs-2025-12-15 - Transform deprecated output_format parameter to output_config.format - Add warning when both output_format and output_config.format are provided - Update beta-parser to support parsing from either location - Update tests to expect new output_config.format structure Co-Authored-By: Claude Code (/Users/davidmeadows/stainless/stainless) <noreply@anthropic.com> * feat: add @deprecated JSDoc tag and update example to use output_config - Add @deprecated JSDoc tag to output_format parameter in BetaParseableMessageCreateParams - Update parsing-zod.ts example to use output_config.format instead of output_format Co-Authored-By: Claude Code (/Users/davidmeadows/stainless/stainless/dist/customer-repos/stainless-sdks/anthropic-typescript) <noreply@anthropic.com> * fix: throw error instead of warning when both output params provided Co-Authored-By: Claude Code (/Users/davidmeadows/stainless/stainless/dist/customer-repos/stainless-sdks/anthropic-typescript) <noreply@anthropic.com> * Remove note about beta header injection * clean up things a bit * revert changes * undo a change * undo changes from next * fixup! * fixes * fixup! * fix: move structured output formatting to dedicated function and add to token counting * feat: Test exception case in structured output * feat: improve types and add other unit test for structured output transformation --------- Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com> Co-authored-by: Claude Code (/Users/davidmeadows/stainless/stainless) <noreply@anthropic.com> Co-authored-by: Cameron McAteer <246350779+cameron-mcateer@users.noreply.github.com>

Add helper functions for integrating with the [Model Context Protocol (MCP) SDK](https://github.com/modelcontextprotocol/sdk). These helpers reduce the boilerplate required to convert MCP types to Anthropic API types from ~100+ lines to single function calls. **New helpers:** - `mcpTool(tool, mcpClient)` - Convert single MCP tool to `BetaRunnableTool` - `mcpTools(tools, mcpClient)` - Convert array of MCP tools to `BetaRunnableTool[]` for use with `toolRunner()` - `mcpMessage(message)` - Convert single MCP `PromptMessage` to `BetaMessageParam` - `mcpMessages(messages)` - Convert array of MCP `PromptMessage` to `BetaMessageParam[]` - `mcpContent(content)` - Convert single MCP content block to Anthropic content block - `mcpResourceToContent(resource)` - Convert MCP resource to content block (document or image) - `mcpResourceToFile(resource)` - Convert MCP resource to `File` for `files.upload()`

felixfbecker

The addition looks nice but would still be good to understand the motivation/use case. Could you add a PR description?

felixfbecker · 2026-01-26T21:39:24Z

src/helpers/beta/json-schema.ts

-  run: (args: NoInfer<FromSchema<Schema>>) => Promisable<string | Array<BetaToolResultContentBlockParam>>;
+  run: (
+    args: NoInfer<FromSchema<Schema>>,
+    context?: BetaToolRunContext,


since "context" is a defined term in the context of LLMs, a different name might be better, e.g. meta

I've renamed it to meta

karpetrosyan · 2026-01-28T13:55:21Z

The addition looks nice but would still be good to understand the motivation/use case. Could you add a PR description?

@felixfbecker It adds metadata to tool runners so they can do some logging/tracing. I’m also preparing an update so we provide an abort signal as well, so tools can be aborted.
I’ve also added a minimal description to the PR.

felixfbecker · 2026-02-05T06:23:11Z

src/helpers/beta/json-schema.ts

-  run: (args: NoInfer<FromSchema<Schema>>) => Promisable<string | Array<BetaToolResultContentBlockParam>>;
+  run: (
+    args: NoInfer<FromSchema<Schema>>,
+    meta?: BetaToolRunMeta,


shouldn't this be required (always passed)?

I tried to make it required, but I don’t think there’s a good way to do it because of TypeScript’s limitations.

sd-st and others added 18 commits November 18, 2025 15:51

don't strip path from filename in multipart

aec4cce

address feedback

c6b2675

address feedback

493258b

fix(mcp): return correct lines on typescript errors

0b98943

chore(internal): codegen related update

2a6e2cd

fix(mcp): correct code tool API endpoint

ba21721

chore(internal): codegen related update

a7fbcd8

chore(internal): version bump

f3e89e8

codegen metadata

be4e942

chore(tests): remove extraneous header test

fd388c6

Merge pull request anthropics#849 from sd-st/fix-multipart-path

9610d4f

fix(client): don't strip path from filename for skills endpoint

chore(ci): Add Claude Code GitHub Workflow (anthropics#612)

0a6c372

* "Claude PR Assistant workflow" * "Claude Code Review workflow"

feat(ci): add breaking change detection workflow

7d51dac

chore: break long lines in snippets into multiline

80e8e4c

chore(ci): fix multi package publishing

a7e605c

docs: tool use documentation link (anthropics#873) (anthropics#616)

ef8da95

Co-authored-by: Vibeke Tengroth <vibeketengroth@gmail.com> Co-authored-by: Packy Gallagher <packy@anthropic.com>

codegen metadata

1521bb0

karpetrosyan requested a review from a team as a code owner January 13, 2026 07:05

karpetrosyan changed the base branch from main to next January 13, 2026 07:45

karpetrosyan force-pushed the add-context-to-tools branch 2 times, most recently from 294d05a to 930d26b Compare January 13, 2026 18:06

stainless-app bot added 6 commits January 14, 2026 16:34

codegen metadata

1d0dc5b

chore(internal): upgrade babel, qs, js-yaml

fe4dca7

feat(api): migrate sending message format in output_config rather tha…

0048e31

…n output_format

chore(internal): update actions/checkout version

425c3d2

chore(ci): upgrade actions/github-script

a582a5a

codegen metadata

65f1581

dtmeadows and others added 2 commits January 26, 2026 09:09

felixfbecker reviewed Jan 26, 2026

View reviewed changes

feat(tool runner): add context parameter to tool run functions

e4f218d

karpetrosyan force-pushed the add-context-to-tools branch from 0e56ab6 to e4f218d Compare January 27, 2026 09:51

stainless-app bot force-pushed the next branch 2 times, most recently from eeb7fab to 7b4849b Compare January 29, 2026 17:24

felixfbecker approved these changes Feb 4, 2026

View reviewed changes

felixfbecker reviewed Feb 5, 2026

View reviewed changes

stainless-app bot force-pushed the next branch 2 times, most recently from 6bcd8a5 to 883bbb6 Compare February 7, 2026 02:56

stainless-app bot force-pushed the next branch from fcac1ca to bcdf5b2 Compare February 17, 2026 19:26

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(tool runner): add context parameter to tool run functions#877

feat(tool runner): add context parameter to tool run functions#877
karpetrosyan wants to merge 27 commits intoanthropics:nextfrom
karpetrosyan:add-context-to-tools

karpetrosyan commented Jan 13, 2026 •

edited

Loading

Uh oh!

felixfbecker commented Jan 13, 2026

Uh oh!

karpetrosyan commented Jan 14, 2026

Uh oh!

felixfbecker left a comment

Uh oh!

felixfbecker Jan 26, 2026

Uh oh!

karpetrosyan Jan 27, 2026

Uh oh!

karpetrosyan commented Jan 28, 2026

Uh oh!

felixfbecker Feb 5, 2026

Uh oh!

karpetrosyan Feb 5, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

Conversation

karpetrosyan commented Jan 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Add context parameter to tool run functions

Usage

Uh oh!

felixfbecker commented Jan 13, 2026

Uh oh!

karpetrosyan commented Jan 14, 2026

Uh oh!

felixfbecker left a comment

Choose a reason for hiding this comment

Uh oh!

felixfbecker Jan 26, 2026

Choose a reason for hiding this comment

Uh oh!

karpetrosyan Jan 27, 2026

Choose a reason for hiding this comment

Uh oh!

karpetrosyan commented Jan 28, 2026

Uh oh!

felixfbecker Feb 5, 2026

Choose a reason for hiding this comment

Uh oh!

karpetrosyan Feb 5, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

karpetrosyan commented Jan 13, 2026 •

edited

Loading