feat: add Anthropic Claude integration

[ryoppippi]

Summary

Add toAnthropic() conversion methods to enable seamless integration with Anthropic's Claude API, allowing StackOne tools to be used directly with Claude models.

What Changed

• Add @anthropic-ai/sdk as optional peer dependency
• Implement BaseTool.toAnthropic() method for single tool conversion
• Implement Tools.toAnthropic() method for collection conversion
• Add comprehensive tests for both methods
• Add example demonstrating Anthropic Claude integration

Usage

import Anthropic from '@anthropic-ai/sdk';
import { StackOneToolSet } from '@stackone/ai';

const toolset = new StackOneToolSet({ accountId: 'your-account-id' });
const tools = await toolset.fetchTools({ actions: ['hris_get_*'] });

// Convert to Anthropic format
const anthropicTools = tools.toAnthropic();

// Use with Anthropic client
const anthropic = new Anthropic();
const response = await anthropic.messages.create({
  model: 'claude-haiku-4-5-20241022',
  max_tokens: 1024,
  tools: anthropicTools,
  messages: [{ role: 'user', content: 'Get employee details...' }],
});

Closes #207

---

Summary by cubic

Add toAnthropic() converters to export StackOne tools to Anthropic’s Tool format, enabling direct use with Claude’s messages API. Includes an example and tests; adds @anthropic-ai/sdk as an optional peer dependency.

• New Features

  • BaseTool.toAnthropic() converts a single tool to Anthropic Tool format (name, description, input_schema).
  • Tools.toAnthropic() converts a collection of tools.
  • Added example and tests to demonstrate and verify Claude tool-use integration.

• Dependencies

  • Added @anthropic-ai/sdk ^0.52.0 as an optional peer dependency.

^{Written for commit b4cc8f9. Summary will update automatically on new commits.}

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/StackOneHQ/stackone-ai-node/@stackone/ai@208

commit: b4cc8f9

[cubic-dev-ai]

No issues found across 7 files

[Copilot]

Pull request overview

This PR adds seamless integration with Anthropic's Claude API by implementing toAnthropic() conversion methods for StackOne tools. The implementation follows the same patterns established for OpenAI integration, with type-safe, optional peer dependency handling.

Key Changes

• Added toAnthropic() methods to BaseTool and Tools classes for converting tool definitions to Anthropic's format
• Added @anthropic-ai/sdk as an optional peer dependency with type-only imports
• Comprehensive test coverage for both single tool and collection conversions

Reviewed changes

Copilot reviewed 6 out of 7 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
src/tool.ts	Implements toAnthropic() methods on BaseTool and Tools classes, converting tool schemas to Anthropic's input_schema format
src/tool.test.ts	Adds comprehensive test coverage for both BaseTool.toAnthropic() and Tools.toAnthropic() methods
pnpm-workspace.yaml	Adds @anthropic-ai/sdk v0.52.0 to peer dependency catalog
pnpm-lock.yaml	Updates lock file with Anthropic SDK dependency resolution
package.json	Adds @anthropic-ai/sdk as optional peer dependency following existing pattern
examples/package.json	Adds @anthropic-ai/sdk to examples for demonstration purposes
examples/anthropic-integration.ts	Provides working example of using StackOne tools with Claude API

Files not reviewed (1)

• pnpm-lock.yaml: Language not supported

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

The model name claude-haiku-4-5-20241022 appears to be incorrect. Based on Anthropic's model naming conventions, this should likely be claude-3-5-haiku-20241022 (Claude 3.5 Haiku from October 2024). There is no publicly documented Claude 4 or Claude 4.5 model as of the knowledge cutoff.

Suggested change

	model: 'claude-haiku-4-5-20241022',
	model: 'claude-3-5-haiku-20241022',

[glebedel]

@ryoppippi conflict on this one

[ryoppippi]

@glebedel fixed!

[glebedel]

LGTM