You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs(readme): reorganise structure and add new integration examples
Reorganise README for improved readability and discoverability:
- Move Development Environment section to the bottom
- Convert integrations to collapsible details sections
- Add Anthropic Claude integration with toAnthropic() usage
- Add OpenAI Responses API integration with toOpenAIResponses()
- Include installation commands within each integration section
- Add bun as a package manager option throughout
- Remove separate "Optional: AI SDK Integration" section
The collapsible sections reduce visual clutter while keeping all
integration documentation easily accessible. Each integration now
includes its required dependencies inline.
content: "You are a helpful HR assistant using BambooHR.",
57
+
},
58
+
{
59
+
role: "user",
60
+
content: "Create a time-off request for employee id cxIQ5764hj2",
61
+
},
62
+
],
63
+
tools: tools.toOpenAI(),
64
+
});
39
65
```
40
66
41
-
## Development Environment
67
+
[View full example](examples/openai-integration.ts)
42
68
43
-
### Using Nix Flake
69
+
</details>
44
70
45
-
This project includes a Nix flake for reproducible development environments. If you have Nix installed with flakes enabled, you can use it to set up your development environment:
@@ -72,25 +118,32 @@ const toolset = new StackOneToolSet({
72
118
73
119
const tools =awaittoolset.fetchTools();
74
120
75
-
awaitopenai.chat.completions.create({
76
-
model: "gpt-5.1",
121
+
const anthropic =newAnthropic();
122
+
123
+
awaitanthropic.messages.create({
124
+
model: "claude-haiku-4-5-20241022",
125
+
max_tokens: 1024,
126
+
system: "You are a helpful HR assistant.",
77
127
messages: [
78
-
{
79
-
role: "system",
80
-
content: "You are a helpful HR assistant using BambooHR.",
81
-
},
82
128
{
83
129
role: "user",
84
-
content: "Create a time-off request for employee id cxIQ5764hj2",
130
+
content: "What is the phone number for employee c28xIQ?",
85
131
},
86
132
],
87
-
tools: tools.toOpenAI(),
133
+
tools: tools.toAnthropic(),
88
134
});
89
135
```
90
136
91
-
[View full example](examples/openai-integration.ts)
137
+
[View full example](examples/anthropic-integration.ts)
138
+
139
+
</details>
140
+
141
+
<details>
142
+
<summary><strong>With AI SDK by Vercel</strong></summary>
92
143
93
-
### AI SDK by Vercel
144
+
```bash
145
+
npm install ai @ai-sdk/openai # or: yarn/pnpm/bun add ai @ai-sdk/openai
146
+
```
94
147
95
148
```typescript
96
149
import { openai } from"@ai-sdk/openai";
@@ -113,6 +166,8 @@ await generateText({
113
166
114
167
[View full example](examples/ai-sdk-integration.ts)
115
168
169
+
</details>
170
+
116
171
## Usage
117
172
118
173
```typescript
@@ -436,3 +491,20 @@ When AI agents use this tool, they will:
436
491
5.**Report results**: Show which accounts received the feedback successfully
437
492
438
493
The tool description includes clear instructions for AI agents to always ask for explicit user consent before submitting feedback.
494
+
495
+
## Development Environment
496
+
497
+
### Using Nix Flake
498
+
499
+
This project includes a Nix flake for reproducible development environments. If you have Nix installed with flakes enabled, you can use it to set up your development environment:
500
+
501
+
```bash
502
+
# Enter development shell
503
+
nix develop
504
+
505
+
# Or use direnv for automatic activation
506
+
echo"use flake"> .envrc
507
+
direnv allow
508
+
```
509
+
510
+
The flake provides all necessary development dependencies including Node.js, pnpm, and other build tools.
0 commit comments