@hasna/connectors 0.2.6 → 0.2.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (73) hide show
  1. package/bin/index.js +3 -3
  2. package/bin/mcp.js +1 -1
  3. package/connectors/connect-anthropic/AGENTS.md +22 -0
  4. package/connectors/connect-anthropic/CLAUDE.md +29 -0
  5. package/connectors/connect-anthropic/README.md +22 -3
  6. package/connectors/connect-anthropic/src/types/index.ts +46 -2
  7. package/connectors/connect-aws/CLAUDE.md +16 -0
  8. package/connectors/connect-brandsight/CLAUDE.md +5 -0
  9. package/connectors/connect-cloudflare/CLAUDE.md +21 -0
  10. package/connectors/connect-discord/CLAUDE.md +19 -0
  11. package/connectors/connect-docker/CLAUDE.md +8 -0
  12. package/connectors/connect-e2b/CLAUDE.md +21 -0
  13. package/connectors/connect-elevenlabs/CLAUDE.md +24 -0
  14. package/connectors/connect-exa/CLAUDE.md +35 -0
  15. package/connectors/connect-figma/CLAUDE.md +34 -0
  16. package/connectors/connect-firecrawl/CLAUDE.md +27 -0
  17. package/connectors/connect-github/CLAUDE.md +32 -2
  18. package/connectors/connect-gmail/CLAUDE.md +22 -0
  19. package/connectors/connect-google/CLAUDE.md +11 -0
  20. package/connectors/connect-googlecalendar/CLAUDE.md +9 -0
  21. package/connectors/connect-googlecloud/CLAUDE.md +12 -0
  22. package/connectors/connect-googlecontacts/CLAUDE.md +7 -0
  23. package/connectors/connect-googledocs/CLAUDE.md +7 -0
  24. package/connectors/connect-googledrive/CLAUDE.md +5 -0
  25. package/connectors/connect-googlegemini/CLAUDE.md +18 -0
  26. package/connectors/connect-googlegemini/src/types/index.ts +10 -3
  27. package/connectors/connect-googlemaps/CLAUDE.md +15 -0
  28. package/connectors/connect-googlesheets/CLAUDE.md +10 -0
  29. package/connectors/connect-googletasks/CLAUDE.md +6 -0
  30. package/connectors/connect-hedra/CLAUDE.md +15 -0
  31. package/connectors/connect-heygen/CLAUDE.md +14 -0
  32. package/connectors/connect-huggingface/CLAUDE.md +20 -0
  33. package/connectors/connect-icons8/CLAUDE.md +6 -0
  34. package/connectors/connect-maropost/CLAUDE.md +6 -0
  35. package/connectors/connect-mercury/CLAUDE.md +14 -0
  36. package/connectors/connect-meta/CLAUDE.md +16 -0
  37. package/connectors/connect-midjourney/CLAUDE.md +7 -0
  38. package/connectors/connect-mistral/CLAUDE.md +20 -0
  39. package/connectors/connect-mistral/src/types/index.ts +42 -7
  40. package/connectors/connect-mixpanel/CLAUDE.md +11 -0
  41. package/connectors/connect-notion/CLAUDE.md +30 -0
  42. package/connectors/connect-openai/AGENTS.md +15 -0
  43. package/connectors/connect-openai/CLAUDE.md +23 -0
  44. package/connectors/connect-openai/src/types/index.ts +36 -14
  45. package/connectors/connect-openweathermap/CLAUDE.md +8 -0
  46. package/connectors/connect-pandadoc/CLAUDE.md +18 -0
  47. package/connectors/connect-quo/CLAUDE.md +5 -0
  48. package/connectors/connect-reddit/CLAUDE.md +20 -0
  49. package/connectors/connect-reducto/CLAUDE.md +16 -0
  50. package/connectors/connect-resend/CLAUDE.md +21 -0
  51. package/connectors/connect-revolut/CLAUDE.md +17 -0
  52. package/connectors/connect-sedo/CLAUDE.md +6 -0
  53. package/connectors/connect-sentry/CLAUDE.md +11 -0
  54. package/connectors/connect-shadcn/CLAUDE.md +42 -0
  55. package/connectors/connect-shopify/CLAUDE.md +18 -0
  56. package/connectors/connect-snap/CLAUDE.md +6 -0
  57. package/connectors/connect-stabilityai/CLAUDE.md +13 -0
  58. package/connectors/connect-stripe/CLAUDE.md +19 -0
  59. package/connectors/connect-stripeatlas/CLAUDE.md +7 -0
  60. package/connectors/connect-substack/CLAUDE.md +6 -0
  61. package/connectors/connect-tiktok/CLAUDE.md +25 -0
  62. package/connectors/connect-tinker/CLAUDE.md +6 -0
  63. package/connectors/connect-twilio/CLAUDE.md +9 -0
  64. package/connectors/connect-uspto/CLAUDE.md +8 -0
  65. package/connectors/connect-webflow/CLAUDE.md +19 -0
  66. package/connectors/connect-wix/CLAUDE.md +20 -0
  67. package/connectors/connect-x/CLAUDE.md +15 -0
  68. package/connectors/connect-xads/CLAUDE.md +10 -0
  69. package/connectors/connect-xai/CLAUDE.md +15 -0
  70. package/connectors/connect-xai/src/types/index.ts +20 -4
  71. package/connectors/connect-youtube/CLAUDE.md +28 -0
  72. package/connectors/connect-zoom/CLAUDE.md +15 -0
  73. package/package.json +1 -1
@@ -47,6 +47,13 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## API Notes (2026)
51
+
52
+ Use **Google People API** (not deprecated Contacts API v3).
53
+ Base URL: `https://people.googleapis.com/v1/`
54
+ Key endpoints: `/people/me`, `/people:listDirectoryPeople`, `/people:batchGet`
55
+ Scopes: `contacts`, `contacts.readonly`, `directory.readonly`, `user.addresses.read`, `user.emails.read`
56
+
50
57
  ## Authentication
51
58
 
52
59
  OAuth authentication. Credentials can be set via:
@@ -47,6 +47,13 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## API Updates (2026)
51
+
52
+ ### Gemini Features (Feb 2026)
53
+ Audio summaries now available in Google Docs — Gemini-powered feature that generates audio overviews of documents.
54
+
55
+ No breaking API changes to the Docs API v1 (stable).
56
+
50
57
  ## Authentication
51
58
 
52
59
  OAuth authentication. Credentials can be set via:
@@ -47,6 +47,11 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## API Updates (2026)
51
+
52
+ ### Deprecation (Feb 2026)
53
+ `enforceExpansiveAccess` query parameter is now deprecated for all methods in the permissions resource (v2 and v3). To restrict item access, use **folders with limited access** setting instead.
54
+
50
55
  ## Authentication
51
56
 
52
57
  OAuth authentication (Google OAuth2). Credentials can be set via:
@@ -47,6 +47,24 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## Models (2026)
51
+
52
+ | Model | Description |
53
+ |-------|-------------|
54
+ | `gemini-3.1-pro-preview` | Latest (Feb 2026), #1 on 13/16 benchmarks, 1M ctx — **use for complex tasks** |
55
+ | `gemini-3.1-pro-preview-customtools` | Agent workflows with custom tools (bash, code, multi-step) |
56
+ | `gemini-3.1-flash-lite` | Fast, budget-friendly (preview) |
57
+ | `gemini-3-pro-preview` | Gemini 3 Pro |
58
+ | `gemini-3-flash-preview` | Frontier performance at fraction of cost |
59
+ | `gemini-2.5-pro` | GA, advanced reasoning (discontinues Jun 17 2026) |
60
+ | `gemini-2.5-flash` | Best price-performance, GA |
61
+ | `gemini-2.5-flash-lite` | Fastest, most budget-friendly |
62
+ | `gemini-2.5-flash-live-preview` | Real-time audio/video Live API |
63
+
64
+ For image gen (Nano Banana): `gemini-2.5-flash-preview-image-generation`
65
+ For video gen (Veo): `veo-3.1-generate-preview`
66
+ For TTS: `gemini-2.5-flash-preview-tts`, `gemini-2.5-pro-preview-tts`
67
+
50
68
  ## Authentication
51
69
 
52
70
  API Key authentication. Credentials can be set via:
@@ -2,19 +2,26 @@
2
2
 
3
3
  // ============ Models ============
4
4
  export type GeminiModel =
5
- // Text Generation Models
5
+ // Gemini 3.1 (Feb 2026, latest)
6
+ | 'gemini-3.1-pro-preview' // Most advanced, tops 13/16 benchmarks
7
+ | 'gemini-3.1-pro-preview-customtools' // Agent/tool-use optimized variant
8
+ | 'gemini-3.1-flash-lite' // Fast, cost-efficient (preview)
9
+ // Gemini 3 (2025-2026)
6
10
  | 'gemini-3-pro-preview'
7
11
  | 'gemini-3-flash-preview'
12
+ // Gemini 2.5 (GA)
8
13
  | 'gemini-2.5-pro'
9
14
  | 'gemini-2.5-flash'
10
15
  | 'gemini-2.5-flash-lite'
11
- // Image Generation Models (Nano Banana)
16
+ // Image Generation (Nano Banana)
12
17
  | 'gemini-2.5-flash-preview-image-generation'
13
18
  | 'gemini-3-pro-image-preview'
14
19
  // TTS Models
15
20
  | 'gemini-2.5-flash-preview-tts'
16
21
  | 'gemini-2.5-pro-preview-tts'
17
- // Embedding Model
22
+ // Live API (real-time audio/video)
23
+ | 'gemini-2.5-flash-live-preview'
24
+ // Embedding
18
25
  | 'gemini-embedding-001'
19
26
  // Legacy
20
27
  | 'gemini-2.0-flash'
@@ -47,6 +47,21 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## API Updates (2025-2026)
51
+
52
+ ### Places API v2 (New)
53
+ New Places API (v2) is preferred over legacy Places API (v1). Use `https://places.googleapis.com/v1/places` endpoints.
54
+
55
+ ### Client IDs Deprecated (May 2025 → May 2026)
56
+ Maps Platform client IDs deprecated May 26, 2025. Cannot be used after May 31, 2026.
57
+ Use API key authentication exclusively.
58
+
59
+ ### Current APIs
60
+ - Places API (New): `https://places.googleapis.com/v1/`
61
+ - Routes API: `https://routes.googleapis.com/`
62
+ - Geocoding API: `https://maps.googleapis.com/maps/api/geocode/json`
63
+ - Maps JavaScript API, Street View, Distance Matrix, etc.
64
+
50
65
  ## Authentication
51
66
 
52
67
  API Key authentication. Credentials can be set via:
@@ -47,6 +47,16 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## API Updates (2025)
51
+
52
+ ### Tables API (Apr 2025)
53
+ Create, modify, and take basic actions on Tables in Google Sheets:
54
+ - `addTable` request in `batchUpdate`
55
+ - `Table` object in Sheets API
56
+
57
+ ### Smart Chips (Jun 2025)
58
+ Create, update, and read Google Drive and People chips via the Sheets API.
59
+
50
60
  ## Authentication
51
61
 
52
62
  OAuth authentication. Credentials can be set via:
@@ -47,6 +47,12 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## API Notes (2026)
51
+
52
+ Google Tasks API v1 is stable. Base URL: `https://tasks.googleapis.com/tasks/v1/`
53
+ Key endpoints: `/lists`, `/lists/{list}/tasks`, `/users/@me/lists`
54
+ Required scope: `https://www.googleapis.com/auth/tasks`
55
+
50
56
  ## Authentication
51
57
 
52
58
  OAuth authentication. Credentials can be set via:
@@ -47,6 +47,21 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## API (Full Platform, Feb 2026)
51
+
52
+ Full Hedra API launched Feb 2026. All models available programmatically.
53
+
54
+ New API endpoints (unified):
55
+ - `GET /models` — list models
56
+ - `POST /assets/generate` — generate image/video/avatar
57
+ - `GET /assets/{id}` — check status
58
+ - `GET /credits` — credit balance
59
+
60
+ Legacy Character-2 API: `POST /v1/characters` (still works)
61
+ Auth: `X-API-Key` header
62
+
63
+ Capabilities: image generation, video generation, avatar generation, Live Avatar (real-time).
64
+
50
65
  ## Authentication
51
66
 
52
67
  Bearer Token authentication. Credentials can be set via:
@@ -47,6 +47,20 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## API Updates (2025-2026)
51
+
52
+ ### Avatar IV Endpoint (Jan 2026)
53
+ ```
54
+ POST /v2/video/av4/generate
55
+ ```
56
+ Photorealistic full-body avatar videos. Speed/quality mode selection.
57
+
58
+ ### Template API Variables (Aug 2025)
59
+ AI Studio templates now support API creation with variable customization: avatars, text, elements, scene scripts.
60
+
61
+ ### Digital Twin — Avatar IV (Aug 2025)
62
+ Full-body digital twins with gestures and emotion.
63
+
50
64
  ## Authentication
51
65
 
52
66
  API Key authentication. Credentials can be set via:
@@ -47,6 +47,26 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## API Updates (2025-2026)
51
+
52
+ ### Serverless Inference API — Overhauled (2026)
53
+ The Serverless Inference API is being completely overhauled. Key changes:
54
+
55
+ New router endpoint pattern:
56
+ ```
57
+ https://router.huggingface.co/hf-inference/models/{model}/v1/chat/completions
58
+ ```
59
+
60
+ For chat completions (OpenAI-compatible):
61
+ ```bash
62
+ curl -X POST https://router.huggingface.co/hf-inference/models/meta-llama/Llama-3.1-8B-Instruct/v1/chat/completions \
63
+ -H "Authorization: Bearer $HF_TOKEN" \
64
+ -H "Content-Type: application/json" \
65
+ -d '{"model": "meta-llama/Llama-3.1-8B-Instruct", "messages": [{"role": "user", "content": "Hello"}]}'
66
+ ```
67
+
68
+ Note: Error responses may return HTML 503 during migration period — handle non-JSON responses gracefully.
69
+
50
70
  ## Authentication
51
71
 
52
72
  Bearer Token authentication. Credentials can be set via:
@@ -47,6 +47,12 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## API Notes (2026)
51
+
52
+ Icons8 API: `https://api.icons8.com/api/iconsets/v5/`
53
+ Key endpoints: `/search`, `/icon`, `/categories`, `/styles`
54
+ Auth: `token` query parameter
55
+
50
56
  ## Authentication
51
57
 
52
58
  API Key authentication. Credentials can be set via:
@@ -47,6 +47,12 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## API Notes (2026)
51
+
52
+ Maropost Marketing Cloud API: `https://api.maropost.com/accounts/{account_id}/`
53
+ Auth: `auth_token` query parameter or Bearer token header.
54
+ Key resources: contacts, campaigns, tags, lists, journeys, reports.
55
+
50
56
  ## Authentication
51
57
 
52
58
  Bearer Token authentication. Credentials can be set via:
@@ -47,6 +47,20 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## New Endpoints (2025-2026)
51
+
52
+ Mercury has been rapidly expanding their API. Recent additions:
53
+ - **Webhooks** — real-time HTTP notifications for account events (transactions, etc.)
54
+ - **Internal Transfers** — `POST /transfer` — move money between accounts (requires `SendMoney` write scope)
55
+ - **Users API** — `GET /api/v1/users` — retrieve organization users
56
+ - **Account Balance Events** — webhooks/events for balance change notifications
57
+ - **SAFE API** — 3 new endpoints for reading SAFE (Simple Agreement for Future Equity) data
58
+ - **Treasury API statements** — programmatic statement retrieval
59
+ - **Attachment uploads** — upload attachments to transactions and recipients
60
+
61
+ Auth: Basic auth (API token as username, empty password) or Bearer token.
62
+ Token tiers: Read-only, Read-write (requires IP whitelist), Custom (scoped).
63
+
50
64
  ## Authentication
51
65
 
52
66
  API Key authentication. Credentials can be set via:
@@ -47,6 +47,22 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## Graph API Updates (2025-2026)
51
+
52
+ ### Current Version: v24.0 (Oct 2025)
53
+
54
+ ### Breaking Changes in v24.0
55
+ - **Advantage+ Shopping/App campaigns**: Cannot be created/updated via API from v24.0 (Feb 2025). Extends to ALL versions by May 19, 2026. Migrate to new Automation Unification workflow.
56
+ - **Customer file custom audiences**: Flagged audiences fail to update (effective Jan 6, 2026 for all versions)
57
+ - **Certificate Transparency**: All endpoints/webhooks removed (Oct 17, 2025)
58
+ - **Live Video API**: `overlay_url` field removed
59
+ - **Messenger lead ads**: Cannot create lead ads that generate leads in Messenger via API
60
+
61
+ ### Upcoming Changes (by Jun 2026)
62
+ - **Page Viewer Metric**: Replaces legacy reach metric — consistent cross-platform measurement (Facebook + Instagram)
63
+ - **Retiring**: Post/Page Reach, Video Impressions, Story Impressions metrics
64
+ - **Webhook permissions**: Updates coming
65
+
50
66
  ## Authentication
51
67
 
52
68
  API Key authentication. Credentials can be set via:
@@ -47,6 +47,13 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## Status (2026) — Important
51
+
52
+ No official public API. The official API is only available to Enterprise subscribers.
53
+ - Official API: `https://api.midjourney.com/v2` with Bearer token (Enterprise only)
54
+ - Current model: **v8** (2026) — text rendering, video gen (10s/60fps), 3D export, `--cref`
55
+ - Unofficial third-party wrappers (Apiframe, TTAPI) available but may violate ToS
56
+
50
57
  ## Authentication
51
58
 
52
59
  Bearer Token authentication. Credentials can be set via:
@@ -47,6 +47,26 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## Models (2026)
51
+
52
+ | Model | Description |
53
+ |-------|-------------|
54
+ | `mistral-large-latest` | Large 3 (Dec 2025), top-tier |
55
+ | `mistral-medium-latest` | Medium 3.1 (Aug 2025), multimodal — **recommended default** |
56
+ | `magistral-medium-latest` | Magistral 1.2 (Sep 2025), reasoning + vision, 40K ctx |
57
+ | `codestral-latest` | Codestral 2508, code specialist, 256K context |
58
+ | `devstral-latest` | Devstral Medium, coding agents, multi-file editing |
59
+ | `ministral-8b-latest` | Edge model, fast and cheap |
60
+ | `ministral-3b-latest` | Fastest edge model |
61
+
62
+ New capabilities (2025-2026):
63
+ - **OCR / Document AI**: `mistral-ocr-2512` via `POST /v1/ocr`
64
+ - **Audio transcription**: `voxtral-mini-2602` via `POST /v1/audio/transcriptions` (with diarize, context biasing)
65
+ - **Reasoning**: Magistral series with extended thinking
66
+ - **Coding agents**: Devstral for multi-file codebase exploration
67
+
68
+ Default: `mistral-medium-latest`
69
+
50
70
  ## Authentication
51
71
 
52
72
  Bearer Token authentication. Credentials can be set via:
@@ -5,26 +5,61 @@ export interface MistralConfig {
5
5
  baseUrl?: string;
6
6
  }
7
7
 
8
- // Models
8
+ // Models (2026)
9
9
  export type MistralModel =
10
- | 'mistral-large-latest'
10
+ // Latest aliases (always point to newest)
11
+ | 'mistral-large-latest' // → mistral-large-2512
12
+ | 'mistral-medium-latest' // → mistral-medium-2508
11
13
  | 'mistral-small-latest'
12
- | 'codestral-latest'
14
+ | 'codestral-latest' // → codestral-2508
15
+ | 'magistral-medium-latest' // → magistral-medium-2509
13
16
  | 'ministral-8b-latest'
14
17
  | 'ministral-3b-latest'
15
- | 'open-mistral-nemo'
16
- | 'pixtral-large-latest';
18
+ | 'pixtral-large-latest'
19
+ | 'devstral-latest'
20
+ // Pinned versions (2025-2026)
21
+ | 'mistral-large-2512' // Mistral Large 3 (Dec 2025)
22
+ | 'mistral-medium-2508' // Mistral Medium 3.1 (Aug 2025)
23
+ | 'mistral-medium-2505' // Mistral Medium 3 (May 2025)
24
+ | 'magistral-medium-2509' // Magistral Medium 1.2 (Sep 2025, reasoning)
25
+ | 'magistral-medium-2507' // Magistral Medium 1.1
26
+ | 'magistral-medium-2506' // Magistral Medium 1.0
27
+ | 'magistral-small-2509' // Magistral Small 1.2
28
+ | 'codestral-2508' // Codestral (Jul 2025, 256K context)
29
+ | 'codestral-2501'
30
+ | 'devstral-medium-2507' // Devstral (coding agents)
31
+ | 'ministral-3b-2512'
32
+ | 'ministral-8b-2512'
33
+ | 'ministral-14b-2512'
34
+ | 'ministral-3b-2410'
35
+ | 'ministral-8b-2410'
36
+ | 'open-mistral-nemo';
17
37
 
18
38
  export type MistralEmbeddingModel = 'mistral-embed';
19
39
 
40
+ export type MistralOCRModel = 'mistral-ocr-2512' | 'mistral-ocr-2505';
41
+
42
+ export type MistralAudioModel = 'voxtral-mini-2602' | 'voxtral-mini-transcribe-realtime-2602' | 'voxtral-mini-2507';
43
+
20
44
  export const MISTRAL_MODELS: MistralModel[] = [
45
+ // Latest aliases
21
46
  'mistral-large-latest',
47
+ 'mistral-medium-latest',
22
48
  'mistral-small-latest',
23
49
  'codestral-latest',
50
+ 'magistral-medium-latest',
24
51
  'ministral-8b-latest',
25
52
  'ministral-3b-latest',
26
- 'open-mistral-nemo',
27
53
  'pixtral-large-latest',
54
+ 'devstral-latest',
55
+ // Pinned versions
56
+ 'mistral-large-2512',
57
+ 'mistral-medium-2508',
58
+ 'magistral-medium-2509',
59
+ 'codestral-2508',
60
+ 'devstral-medium-2507',
61
+ 'ministral-14b-2512',
62
+ 'open-mistral-nemo',
28
63
  ];
29
64
 
30
65
  // Chat Completions
@@ -156,7 +191,7 @@ export interface EmbeddingOptions {
156
191
  model?: MistralEmbeddingModel | string;
157
192
  }
158
193
 
159
- export const DEFAULT_CHAT_MODEL: MistralModel = 'mistral-small-latest';
194
+ export const DEFAULT_CHAT_MODEL: MistralModel = 'mistral-medium-latest';
160
195
  export const DEFAULT_EMBEDDING_MODEL: MistralEmbeddingModel = 'mistral-embed';
161
196
 
162
197
  // Common types
@@ -47,6 +47,17 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## API Notes (2026)
51
+
52
+ Base URLs:
53
+ - Ingestion: `https://api.mixpanel.com/`
54
+ - Query (EU): `https://eu.mixpanel.com/api/query/`
55
+
56
+ Auth: Service Account credentials (username:password as HTTP Basic Auth) for Query API. Project token for Ingestion API.
57
+
58
+ Key endpoints: `/track` (events), `/engage` (user profiles), `/groups` (group analytics), `/import` (batch import).
59
+ Query API: `/segmentation`, `/funnel`, `/retention`, `/events`.
60
+
50
61
  ## Authentication
51
62
 
52
63
  API Key authentication. Credentials can be set via:
@@ -56,6 +56,36 @@ src/
56
56
  └── index.ts # Library exports
57
57
  ```
58
58
 
59
+ ## API Version (2026) — BREAKING CHANGES
60
+
61
+ ### Current Version: `2026-03-11`
62
+ Set header: `Notion-Version: 2026-03-11`
63
+ SDK: upgrade to `@notionhq/client` v5.12.0+
64
+
65
+ ### Breaking Changes in `2026-03-11`
66
+
67
+ | Change | Old (`2025-09-03`) | New (`2026-03-11`) |
68
+ |--------|-------------------|-------------------|
69
+ | Block positioning | `after: "block-id"` string | `position: { type: "after_block", after_block: { id: "..." } }` |
70
+ | Trash status | `archived: true/false` | `in_trash: true/false` |
71
+ | Block type | `transcription` | `meeting_notes` |
72
+
73
+ #### 1. Replace `after` → `position` (Append Block Children)
74
+ ```json
75
+ // NEW: PATCH /v1/blocks/{id}/children
76
+ { "position": { "type": "after_block", "after_block": { "id": "b5d8fd79-..." } }, "children": [...] }
77
+ // position types: "after_block", "start", "end"
78
+ ```
79
+
80
+ #### 2. Replace `archived` → `in_trash`
81
+ ```json
82
+ // NEW: PATCH /v1/pages/{id}
83
+ { "in_trash": true }
84
+ ```
85
+ Applies to pages, databases, blocks, and data sources in both requests AND responses.
86
+
87
+ #### 3. Replace `transcription` → `meeting_notes` block type
88
+
59
89
  ## Authentication
60
90
 
61
91
  Two authentication methods supported:
@@ -6,6 +6,21 @@ This file provides guidance to AI coding agents when working with this repositor
6
6
 
7
7
  connect-openai is a TypeScript CLI and library for OpenAI's API. It provides chat completions, embeddings, and image generation with multi-profile support.
8
8
 
9
+ ## Models (2026)
10
+
11
+ | Model | Description |
12
+ |-------|-------------|
13
+ | `gpt-5.4` | Latest, most capable |
14
+ | `gpt-4.1-mini` | Fast, cheap — **use as default** |
15
+ | `gpt-4.1` | High capability |
16
+ | `o3` | Advanced reasoning |
17
+ | `o4-mini` | Fast reasoning |
18
+ | `gpt-image-1` | Image generation (preferred over DALL-E 3) |
19
+
20
+ Default: `gpt-4.1-mini`
21
+
22
+ Note: GPT-4o, GPT-4.1, o4-mini retired from **ChatGPT** Feb 2026 — still available in API.
23
+
9
24
  ## Build & Run Commands
10
25
 
11
26
  ```bash
@@ -47,6 +47,29 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## Models (2026)
51
+
52
+ | Model | Description |
53
+ |-------|-------------|
54
+ | `gpt-5.4` | Latest GPT-5, most capable |
55
+ | `gpt-5.2` / `gpt-5.1` | GPT-5 variants |
56
+ | `gpt-4.1` | High-capability, cost-effective |
57
+ | `gpt-4.1-mini` | Fast and cheap — **recommended default** |
58
+ | `gpt-4o` | Still supported in API (retired from ChatGPT Feb 2026) |
59
+ | `o4-mini` | Reasoning model, fast |
60
+ | `o3` | Advanced reasoning |
61
+ | `gpt-image-1` | Native image generation (replaces DALL-E 3 for new projects) |
62
+
63
+ Default: `gpt-4.1-mini`
64
+
65
+ ## Responses API (2025+)
66
+
67
+ For agentic use cases, prefer the **Responses API** over Chat Completions:
68
+ - Built-in tools: file search, code interpreter, image generation, MCP support
69
+ - Stateful conversations
70
+ - Endpoint: `POST /v1/responses`
71
+ - Use Chat Completions for simple text generation; Responses API for agents
72
+
50
73
  ## Authentication
51
74
 
52
75
  Bearer Token authentication. Credentials can be set via:
@@ -6,39 +6,61 @@ export interface OpenAIConfig {
6
6
  organization?: string;
7
7
  }
8
8
 
9
- // Models
9
+ // Models (2026)
10
10
  export type OpenAIModel =
11
+ // GPT-5 series (2025-2026, latest)
12
+ | 'gpt-5.4'
13
+ | 'gpt-5.2'
14
+ | 'gpt-5.1'
15
+ | 'gpt-5'
16
+ // GPT-4.1 series (2025)
17
+ | 'gpt-4.1'
18
+ | 'gpt-4.1-mini'
19
+ // GPT-4o (still supported in API)
11
20
  | 'gpt-4o'
12
21
  | 'gpt-4o-mini'
22
+ // o-series reasoning models
23
+ | 'o4-mini'
24
+ | 'o3'
25
+ | 'o3-mini'
26
+ | 'o1'
27
+ // Legacy
13
28
  | 'gpt-4-turbo'
14
29
  | 'gpt-4'
15
- | 'gpt-3.5-turbo'
16
- | 'o1'
17
- | 'o1-mini'
18
- | 'o1-preview'
19
- | 'o3-mini';
30
+ | 'gpt-3.5-turbo';
20
31
 
21
32
  export type EmbeddingModel =
22
33
  | 'text-embedding-3-small'
23
34
  | 'text-embedding-3-large'
24
35
  | 'text-embedding-ada-002';
25
36
 
26
- export type ImageModel = 'dall-e-3' | 'dall-e-2';
37
+ export type ImageModel = 'gpt-image-1' | 'dall-e-3' | 'dall-e-2';
27
38
 
28
- export type TTSModel = 'tts-1' | 'tts-1-hd';
39
+ export type TTSModel = 'tts-1' | 'tts-1-hd' | 'gpt-4o-mini-tts';
29
40
 
30
- export type STTModel = 'whisper-1';
41
+ export type STTModel = 'whisper-1' | 'gpt-4o-transcribe';
31
42
 
32
43
  export const OPENAI_MODELS: OpenAIModel[] = [
44
+ // GPT-5 series
45
+ 'gpt-5.4',
46
+ 'gpt-5.2',
47
+ 'gpt-5.1',
48
+ 'gpt-5',
49
+ // GPT-4.1
50
+ 'gpt-4.1',
51
+ 'gpt-4.1-mini',
52
+ // GPT-4o
33
53
  'gpt-4o',
34
54
  'gpt-4o-mini',
55
+ // o-series
56
+ 'o4-mini',
57
+ 'o3',
58
+ 'o3-mini',
59
+ 'o1',
60
+ // Legacy
35
61
  'gpt-4-turbo',
36
62
  'gpt-4',
37
63
  'gpt-3.5-turbo',
38
- 'o1',
39
- 'o1-mini',
40
- 'o1-preview',
41
- 'o3-mini',
42
64
  ];
43
65
 
44
66
  // Chat Completions
@@ -213,7 +235,7 @@ export interface ImageOptions {
213
235
  n?: number;
214
236
  }
215
237
 
216
- export const DEFAULT_CHAT_MODEL: OpenAIModel = 'gpt-4o-mini';
238
+ export const DEFAULT_CHAT_MODEL: OpenAIModel = 'gpt-4.1-mini';
217
239
  export const DEFAULT_EMBEDDING_MODEL: EmbeddingModel = 'text-embedding-3-small';
218
240
  export const DEFAULT_IMAGE_MODEL: ImageModel = 'dall-e-3';
219
241
 
@@ -47,6 +47,14 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## API Notes (2026)
51
+
52
+ Current version: **API 3.0** (One Call API 3.0) — requires subscription.
53
+ - Free tier: `https://api.openweathermap.org/data/2.5/` (weather, forecast)
54
+ - API 3.0: `https://api.openweathermap.org/data/3.0/onecall` (includes minutely, hourly, daily, alerts)
55
+ - Air Pollution: `https://api.openweathermap.org/data/2.5/air_pollution`
56
+ - Auth: `?appid={API_KEY}` query parameter
57
+
50
58
  ## Authentication
51
59
 
52
60
  API Key authentication. Credentials can be set via:
@@ -47,6 +47,24 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## API Updates (2025)
51
+
52
+ ### New API Capabilities (Jun 2025)
53
+ - **Update documents with images** via API
54
+ - **Create templates from URLs** (no manual upload)
55
+ - **SMS consent tracking** via API
56
+ - **Editing session tokens** without adding users
57
+ - **Programmatic API key creation** for workspace setup automation
58
+
59
+ ### Document Settings Changes (v7.14.0)
60
+ - `expires_in` property added to `GET/PATCH /documents/{id}/settings` responses
61
+ - `qualified_electronic_signature` removed from template settings
62
+
63
+ ### Integrations (Jun 2025)
64
+ - PandaDoc CPQ for Pipedrive (two-way sync)
65
+ - QuickBooks Online integration (estimates + invoices)
66
+ - Recurring payments via Stripe from documents
67
+
50
68
  ## Authentication
51
69
 
52
70
  API Key authentication. Credentials can be set via:
@@ -47,6 +47,11 @@ src/
47
47
  └── index.ts # Library exports
48
48
  ```
49
49
 
50
+ ## API Notes (2026)
51
+
52
+ Quo business quoting and invoicing API. Check https://quo.app/docs for latest API reference.
53
+ Auth: API key via Authorization header.
54
+
50
55
  ## Authentication
51
56
 
52
57
  API Key authentication. Credentials can be set via: