@devries-cameron20 / composio Mirror · read-only / commits / 2fcaa45ee
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 22, 18:15 UTC

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