Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
feat - remove migration
sjd9021 committed
Dec 10, 2025 at 12:42 UTC
2fcaa45eebd855ea633f7e34c19b5353fb71c31e
2 files changed
+101
-195
fern/pages/src/changelog/12-09-25.md
deleted
-195
@@ -1,195 +0,0 @@
1
-# Typed Responses Across Toolkits
2
-
3
-We converted previously generic dict responses to typed schemas across all the following affected toolkits. Example below shows the Outlook List Messages action.
4
-
5
-## Why This Matters
6
-- Better developer experience for direct execute: clear fields and types
7
-- Improved agent performance: flatter output shapes with explicit fields reduce nesting and invalid params
8
-- Clearer docs and type safety: richer metadata for IDEs and autocomplete
9
-
10
-**Impacted toolkits:**
11
-- **ahrefs**
12
-- **airtable**
13
-- **apollo**
14
-- **apify**
15
-- **attio**
16
-- **brex**
17
-- **calendly**
18
-- **canva**
19
-- **clickup**
20
-- **coda**
21
-- **confluence**
22
-- **discordbot**
23
-- **elevenlabs**
24
-- **exa**
25
-- **facebook**
26
-- **figma**
27
-- **firecrawl**
28
-- **fireflies**
29
-- **freshdesk**
30
-- **google_maps**
31
-- **google_search_console**
32
-- **googledocs**
33
-- **googletasks**
34
-- **heygen**
35
-- **hubspot**
36
-- **instagram**
37
-- **instantly**
38
-- **intercom**
39
-- **klaviyo**
40
-- **kommo**
41
-- **linear**
42
-- **linkedin**
43
-- **lmnt**
44
-- **mem0**
45
-- **metaads**
46
-- **microsoft_teams**
47
-- **notion**
48
-- **one_drive**
49
-- **outlook**
50
-- **pplx**
51
-- **quickbooks**
52
-- **ramp**
53
-- **reddit**
54
-- **salesforce**
55
-- **serpapi**
56
-- **shopify**
57
-- **stripe**
58
-- **tavily**
59
-- **tiktok**
60
-- **todoist**
61
-- **xero**
62
-- **youtube**
63
-- **zendesk**
64
-- **zoom**
65
-
66
-## Before vs After
67
-**Now (typed example – Outlook List Messages, 20251209_00):**
68
-```json
69
-{
70
- "data": {
71
- "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('me')/messages",
72
- "@odata.nextLink": "https://graph.microsoft.com/v1.0/me/messages?$skip=10",
73
- "value": [
74
- {
75
- "id": "abc123",
76
- "subject": "Hi there",
77
- "from": { "emailAddress": { "address": "a@b.com", "name": "Alice" } },
78
- "hasAttachments": true
79
- }
80
- ]
81
- },
82
- "successful": true
83
-}
84
-```
85
-
86
-**Previous (generic, 20251202_00):**
87
-```json
88
-{
89
- "data": {
90
- "response_data": { "...": "..." }
91
- },
92
- "successful": true
93
-}
94
-```
95
-
96
-For the exact field mapping per toolkit, open `platform.composio.dev` → Toolkits → List Messages (or the relevant tool).
97
-
98
-## Migration Notes
99
-- Breaking change for consumers on the `latest` version who post-process the old nested `response_data` shape: outputs are now flattened and explicitly typed.
100
-- New and modified fields include richer descriptions and examples; some legacy placeholders were removed.
101
-- Re-fetch schemas for your tool/version to see the typed definitions. Use the toolkit view in `platform.composio.dev` for authoritative field details.
102
-
103
-## Schema Diff Snippets
104
-Quick scripts to compare input/output schema changes between tool versions. Fill in `TOOL_SLUG`, `VERSION_OLD`, `VERSION_NEW`, and `API_KEY`, then run locally to see unified diffs.
105
-
106
-**Python:**
107
-```python
108
-import json, requests
109
-from difflib import unified_diff
110
-
111
-TOOL_SLUG = "" # required
112
-VERSION_OLD = "YYYYMMDD_NN"
113
-VERSION_NEW = "YYYYMMDD_NN"
114
-API_KEY = "your-api-key"
115
-
116
-def fetch(version):
117
- r = requests.get(
118
- f"https://backend.composio.dev/api/v3/tools/{TOOL_SLUG}",
119
- params={"version": version},
120
- headers={"x-api-key": API_KEY},
121
- )
122
- r.raise_for_status()
123
- return r.json()
124
-
125
-old, new = fetch(VERSION_OLD), fetch(VERSION_NEW)
126
-for label, a, b in [
127
- ("INPUT", old.get("input_parameters", {}), new.get("input_parameters", {})),
128
- ("OUTPUT", old.get("output_parameters", {}), new.get("output_parameters", {})),
129
-]:
130
- print(f"\n{label} DIFF\n" + "=" * 20)
131
- diff = unified_diff(
132
- json.dumps(a, indent=2, sort_keys=True).splitlines(),
133
- json.dumps(b, indent=2, sort_keys=True).splitlines(),
134
- lineterm="",
135
- )
136
- print("\n".join(diff) or "No changes")
137
-```
138
-
139
-**TypeScript:**
140
-```typescript
141
-import { diffLines } from "diff";
142
-
143
-const TOOL_SLUG = ""; // required
144
-const VERSION_OLD = "YYYYMMDD_NN";
145
-const VERSION_NEW = "YYYYMMDD_NN";
146
-const API_KEY = "your-api-key";
147
-
148
-async function fetchTool(version: string) {
149
- const res = await fetch(
150
- `https://backend.composio.dev/api/v3/tools/${TOOL_SLUG}?version=${version}`,
151
- { headers: { "x-api-key": API_KEY } }
152
- );
153
- if (!res.ok) throw new Error(await res.text());
154
- return res.json();
155
-}
156
-
157
-function printDiff(label: string, oldText: string, newText: string) {
158
- const diff = diffLines(oldText, newText);
159
- console.log(`\n${label} DIFF\n${"=".repeat(20)}`);
160
- if (diff.length === 1 && !diff[0].added && !diff[0].removed) {
161
- console.log("No changes");
162
- return;
163
- }
164
- diff.forEach((part) =>
165
- part.value
166
- .split("\n")
167
- .filter(Boolean)
168
- .forEach((line) =>
169
- console.log(part.added ? `+ ${line}` : part.removed ? `- ${line}` : ` ${line}`)
170
- )
171
- );
172
-}
173
-
174
-async function main() {
175
- const [oldTool, newTool] = await Promise.all([
176
- fetchTool(VERSION_OLD),
177
- fetchTool(VERSION_NEW),
178
- ]);
179
- printDiff(
180
- "INPUT",
181
- JSON.stringify(oldTool.input_parameters || {}, null, 2),
182
- JSON.stringify(newTool.input_parameters || {}, null, 2)
183
- );
184
- printDiff(
185
- "OUTPUT",
186
- JSON.stringify(oldTool.output_parameters || {}, null, 2),
187
- JSON.stringify(newTool.output_parameters || {}, null, 2)
188
- );
189
-}
190
-
191
-main().catch((e) => {
192
- console.error(e.message);
193
- process.exit(1);
194
-});
195
-```
fern/pages/src/changelog/12-10-25.md
new
+101
@@ -0,0 +1,101 @@
1
+# Typed Responses Across Toolkits
2
+
3
+We converted previously generic dict responses to typed schemas across all the following affected toolkits. Example below shows the Outlook List Messages action.
4
+
5
+## Why This Matters
6
+- Better developer experience for direct execute: clear fields and types
7
+- Improved agent performance: flatter output shapes with explicit fields reduce nesting and invalid params
8
+- Clearer docs and type safety: richer metadata for IDEs and autocomplete
9
+
10
+**Impacted toolkits:**
11
+- **ahrefs**
12
+- **airtable**
13
+- **apollo**
14
+- **apify**
15
+- **attio**
16
+- **brex**
17
+- **calendly**
18
+- **canva**
19
+- **clickup**
20
+- **coda**
21
+- **confluence**
22
+- **discordbot**
23
+- **elevenlabs**
24
+- **exa**
25
+- **facebook**
26
+- **figma**
27
+- **firecrawl**
28
+- **fireflies**
29
+- **freshdesk**
30
+- **google_maps**
31
+- **google_search_console**
32
+- **googledocs**
33
+- **googletasks**
34
+- **heygen**
35
+- **hubspot**
36
+- **instagram**
37
+- **instantly**
38
+- **intercom**
39
+- **klaviyo**
40
+- **kommo**
41
+- **linear**
42
+- **linkedin**
43
+- **lmnt**
44
+- **mem0**
45
+- **metaads**
46
+- **microsoft_teams**
47
+- **notion**
48
+- **one_drive**
49
+- **outlook**
50
+- **pplx**
51
+- **quickbooks**
52
+- **ramp**
53
+- **reddit**
54
+- **salesforce**
55
+- **serpapi**
56
+- **shopify**
57
+- **stripe**
58
+- **tavily**
59
+- **tiktok**
60
+- **todoist**
61
+- **xero**
62
+- **youtube**
63
+- **zendesk**
64
+- **zoom**
65
+
66
+## Before vs After
67
+**Now (typed example – Outlook List Messages, 20251209_00):**
68
+```json
69
+{
70
+ "data": {
71
+ "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('me')/messages",
72
+ "@odata.nextLink": "https://graph.microsoft.com/v1.0/me/messages?$skip=10",
73
+ "value": [
74
+ {
75
+ "id": "abc123",
76
+ "subject": "Hi there",
77
+ "from": { "emailAddress": { "address": "a@b.com", "name": "Alice" } },
78
+ "hasAttachments": true
79
+ }
80
+ ]
81
+ },
82
+ "successful": true
83
+}
84
+```
85
+
86
+**Previous (generic, 20251202_00):**
87
+```json
88
+{
89
+ "data": {
90
+ "response_data": { "...": "..." }
91
+ },
92
+ "successful": true
93
+}
94
+```
95
+
96
+For the exact field mapping per toolkit, open `platform.composio.dev` → Toolkits → List Messages (or the relevant tool).
97
+
98
+## Migration Notes
99
+- Breaking change for consumers on the `latest` version who post-process the old nested `response_data` shape: outputs are now flattened and explicitly typed.
100
+- New and modified fields include richer descriptions and examples; some legacy placeholders were removed.
101
+- Re-fetch schemas for your tool/version to see the typed definitions. Use the toolkit view in `platform.composio.dev` for authoritative field details.
\ No newline at end of file