@agent-native/core 0.109.0 → 0.109.2

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 (154) hide show
  1. package/corpus/README.md +2 -2
  2. package/corpus/core/CHANGELOG.md +14 -0
  3. package/corpus/core/docs/content/integrations.mdx +87 -253
  4. package/corpus/core/package.json +1 -1
  5. package/corpus/core/src/a2a/client.ts +24 -2
  6. package/corpus/core/src/a2a/correlation.ts +50 -0
  7. package/corpus/core/src/a2a/handlers.ts +140 -14
  8. package/corpus/core/src/a2a/index.ts +1 -0
  9. package/corpus/core/src/a2a/invoke.ts +10 -1
  10. package/corpus/core/src/a2a/task-store.ts +146 -6
  11. package/corpus/core/src/a2a/types.ts +16 -0
  12. package/corpus/core/src/action.ts +2 -0
  13. package/corpus/core/src/agent/production-agent.ts +23 -0
  14. package/corpus/core/src/client/blocks/library/diagram.config.ts +10 -1
  15. package/corpus/core/src/client/blocks/library/diagram.tsx +9 -4
  16. package/corpus/core/src/client/use-run-stuck-detection.ts +27 -1
  17. package/corpus/core/src/db/client.ts +55 -0
  18. package/corpus/core/src/deploy/build.ts +63 -3
  19. package/corpus/core/src/observability/traces.ts +172 -19
  20. package/corpus/core/src/scripts/call-agent.ts +53 -2
  21. package/corpus/core/src/server/agent-chat/action-filters-a2a.ts +72 -25
  22. package/corpus/core/src/server/agent-chat-plugin.ts +107 -6
  23. package/corpus/core/src/templates/workspace-core/.agents/skills/a2a-protocol/SKILL.md +21 -0
  24. package/corpus/core/src/templates/workspace-core/.agents/skills/observability/SKILL.md +7 -1
  25. package/corpus/core/src/templates/workspace-core/.agents/skills/tracking/SKILL.md +1 -1
  26. package/corpus/templates/analytics/actions/query-agent-native-analytics.ts +1 -1
  27. package/corpus/templates/analytics/changelog/2026-07-17-analytics-now-includes-a-default-alert-for-spikes-in-stuck-agent-chats.md +6 -0
  28. package/corpus/templates/analytics/docs/schemas/first-party-analytics.md +23 -14
  29. package/corpus/templates/analytics/docs/schemas/tracked-events.md +5 -1
  30. package/corpus/templates/analytics/server/jobs/analytics-alerts.ts +3 -3
  31. package/corpus/templates/analytics/server/lib/analytics-alerts.ts +209 -87
  32. package/corpus/templates/clips/.agents/skills/dictate/SKILL.md +28 -5
  33. package/corpus/templates/clips/.agents/skills/meetings/SKILL.md +7 -0
  34. package/corpus/templates/clips/.agents/skills/recording/SKILL.md +23 -0
  35. package/corpus/templates/clips/AGENTS.md +10 -0
  36. package/corpus/templates/clips/actions/create-dictation.ts +29 -4
  37. package/corpus/templates/clips/actions/finalize-recording.ts +542 -65
  38. package/corpus/templates/clips/actions/get-recording-player-data.ts +16 -6
  39. package/corpus/templates/clips/actions/set-mobile-capture-state.ts +37 -0
  40. package/corpus/templates/clips/actions/update-dictation.ts +9 -1
  41. package/corpus/templates/clips/app/components/player/playback-comment-overlay.tsx +17 -2
  42. package/corpus/templates/clips/app/components/player/video-player.tsx +14 -2
  43. package/corpus/templates/clips/app/components/recorder/recorder-engine.ts +2 -2
  44. package/corpus/templates/clips/app/routes/r.$recordingId.tsx +14 -3
  45. package/corpus/templates/clips/app/routes/record.tsx +3 -3
  46. package/corpus/templates/clips/app/routes/share.$shareId.tsx +19 -5
  47. package/corpus/templates/clips/changelog/2026-07-17-capture-dictation-background-meeting-audio-and-camera-videos.md +6 -0
  48. package/corpus/templates/clips/changelog/2026-07-17-clips-now-retries-storage-verification-in-the-background-ins.md +6 -0
  49. package/corpus/templates/clips/changelog/2026-07-17-delayed-upload-verification-keeps-local-backups-retryable.md +6 -0
  50. package/corpus/templates/clips/changelog/2026-07-17-fixed-broken-thumbnail-icons-appearing-over-playable-clip-em.md +6 -0
  51. package/corpus/templates/clips/changelog/2026-07-17-playback-comments-stay-readable-at-faster-playback-speeds.md +6 -0
  52. package/corpus/templates/clips/chrome-extension/src/finalize-recovery.ts +3 -0
  53. package/corpus/templates/clips/chrome-extension/src/offscreen.ts +3 -3
  54. package/corpus/templates/clips/desktop/src/app.tsx +35 -6
  55. package/corpus/templates/clips/desktop/src/lib/processing-backup-recovery.ts +19 -0
  56. package/corpus/templates/clips/desktop/src/lib/recorder.ts +141 -18
  57. package/corpus/templates/clips/desktop/src/lib/upload-verification.ts +28 -7
  58. package/corpus/templates/clips/desktop/src-tauri/src/lib.rs +3 -4
  59. package/corpus/templates/clips/desktop/src-tauri/src/native_screen/live_upload.rs +32 -15
  60. package/corpus/templates/clips/desktop/src-tauri/src/native_screen.rs +59 -18
  61. package/corpus/templates/clips/server/db/schema.ts +9 -1
  62. package/corpus/templates/clips/server/jobs/media-verification.ts +130 -0
  63. package/corpus/templates/clips/server/lib/builder-media-compression.ts +74 -7
  64. package/corpus/templates/clips/server/lib/media-verification-state.ts +55 -0
  65. package/corpus/templates/clips/server/lib/player-thumbnail-url.ts +31 -0
  66. package/corpus/templates/clips/server/lib/post-finalize-dispatch.ts +10 -3
  67. package/corpus/templates/clips/server/plugins/auth.ts +5 -5
  68. package/corpus/templates/clips/server/plugins/calendar-jobs.ts +2 -0
  69. package/corpus/templates/clips/server/routes/api/_agent-native-background/post-finalize-worker.post.ts +12 -2
  70. package/corpus/templates/clips/server/routes/api/public-recording.get.ts +13 -1
  71. package/corpus/templates/clips/server/routes/api/thumbnail/[recordingId].get.ts +340 -0
  72. package/corpus/templates/clips/server/routes/api/uploads/[recordingId]/abort.post.ts +24 -7
  73. package/corpus/templates/clips/server/routes/api/uploads/[recordingId]/chunk.post.ts +91 -7
  74. package/corpus/templates/clips/server/routes/api/uploads/[recordingId]/reset-chunks.post.ts +22 -1
  75. package/corpus/templates/clips/server/routes/api/uploads/[recordingId]/status.get.ts +14 -0
  76. package/corpus/templates/clips/shared/finalize-recovery.ts +61 -2
  77. package/corpus/templates/clips/shared/share-meta.ts +1 -1
  78. package/corpus/templates/plan/changelog/2026-07-17-diagrams-can-opt-into-a-polished-clean-rendering-mode-withou.md +6 -0
  79. package/corpus/templates/plan/shared/plan-content.ts +3 -0
  80. package/dist/a2a/client.d.ts +11 -2
  81. package/dist/a2a/client.d.ts.map +1 -1
  82. package/dist/a2a/client.js +16 -3
  83. package/dist/a2a/client.js.map +1 -1
  84. package/dist/a2a/correlation.d.ts +10 -0
  85. package/dist/a2a/correlation.d.ts.map +1 -0
  86. package/dist/a2a/correlation.js +40 -0
  87. package/dist/a2a/correlation.js.map +1 -0
  88. package/dist/a2a/handlers.d.ts.map +1 -1
  89. package/dist/a2a/handlers.js +100 -15
  90. package/dist/a2a/handlers.js.map +1 -1
  91. package/dist/a2a/index.d.ts +1 -1
  92. package/dist/a2a/index.d.ts.map +1 -1
  93. package/dist/a2a/index.js.map +1 -1
  94. package/dist/a2a/invoke.d.ts +4 -1
  95. package/dist/a2a/invoke.d.ts.map +1 -1
  96. package/dist/a2a/invoke.js +3 -0
  97. package/dist/a2a/invoke.js.map +1 -1
  98. package/dist/a2a/task-store.d.ts +12 -1
  99. package/dist/a2a/task-store.d.ts.map +1 -1
  100. package/dist/a2a/task-store.js +96 -6
  101. package/dist/a2a/task-store.js.map +1 -1
  102. package/dist/a2a/types.d.ts +15 -0
  103. package/dist/a2a/types.d.ts.map +1 -1
  104. package/dist/a2a/types.js.map +1 -1
  105. package/dist/action.d.ts +2 -0
  106. package/dist/action.d.ts.map +1 -1
  107. package/dist/action.js.map +1 -1
  108. package/dist/agent/production-agent.d.ts +9 -0
  109. package/dist/agent/production-agent.d.ts.map +1 -1
  110. package/dist/agent/production-agent.js +14 -0
  111. package/dist/agent/production-agent.js.map +1 -1
  112. package/dist/client/blocks/library/diagram.config.d.ts +2 -0
  113. package/dist/client/blocks/library/diagram.config.d.ts.map +1 -1
  114. package/dist/client/blocks/library/diagram.config.js +8 -1
  115. package/dist/client/blocks/library/diagram.config.js.map +1 -1
  116. package/dist/client/blocks/library/diagram.d.ts.map +1 -1
  117. package/dist/client/blocks/library/diagram.js +9 -4
  118. package/dist/client/blocks/library/diagram.js.map +1 -1
  119. package/dist/client/use-run-stuck-detection.d.ts.map +1 -1
  120. package/dist/client/use-run-stuck-detection.js +25 -1
  121. package/dist/client/use-run-stuck-detection.js.map +1 -1
  122. package/dist/collab/routes.d.ts +1 -1
  123. package/dist/db/client.d.ts +7 -0
  124. package/dist/db/client.d.ts.map +1 -1
  125. package/dist/db/client.js +33 -0
  126. package/dist/db/client.js.map +1 -1
  127. package/dist/deploy/build.d.ts +3 -0
  128. package/dist/deploy/build.d.ts.map +1 -1
  129. package/dist/deploy/build.js +45 -1
  130. package/dist/deploy/build.js.map +1 -1
  131. package/dist/observability/routes.d.ts +1 -1
  132. package/dist/observability/traces.d.ts +9 -0
  133. package/dist/observability/traces.d.ts.map +1 -1
  134. package/dist/observability/traces.js +137 -19
  135. package/dist/observability/traces.js.map +1 -1
  136. package/dist/progress/routes.d.ts +1 -1
  137. package/dist/scripts/call-agent.d.ts.map +1 -1
  138. package/dist/scripts/call-agent.js +35 -3
  139. package/dist/scripts/call-agent.js.map +1 -1
  140. package/dist/server/agent-chat/action-filters-a2a.d.ts +18 -2
  141. package/dist/server/agent-chat/action-filters-a2a.d.ts.map +1 -1
  142. package/dist/server/agent-chat/action-filters-a2a.js +35 -7
  143. package/dist/server/agent-chat/action-filters-a2a.js.map +1 -1
  144. package/dist/server/agent-chat-plugin.d.ts.map +1 -1
  145. package/dist/server/agent-chat-plugin.js +93 -6
  146. package/dist/server/agent-chat-plugin.js.map +1 -1
  147. package/dist/templates/workspace-core/.agents/skills/a2a-protocol/SKILL.md +21 -0
  148. package/dist/templates/workspace-core/.agents/skills/observability/SKILL.md +7 -1
  149. package/dist/templates/workspace-core/.agents/skills/tracking/SKILL.md +1 -1
  150. package/docs/content/integrations.mdx +87 -253
  151. package/package.json +1 -1
  152. package/src/templates/workspace-core/.agents/skills/a2a-protocol/SKILL.md +21 -0
  153. package/src/templates/workspace-core/.agents/skills/observability/SKILL.md +7 -1
  154. package/src/templates/workspace-core/.agents/skills/tracking/SKILL.md +1 -1
@@ -144,6 +144,27 @@ message delegation for planning, synthesis, multi-step work, or mutations.
144
144
  Inside an agent loop, `call-agent` exposes the same path with `action` + `input`;
145
145
  omit `message` and `taskId` in that mode.
146
146
 
147
+ ### Retry safety and trace linkage
148
+
149
+ `call-agent` automatically derives an owner-scoped idempotency key from the
150
+ originating turn, target, and exact message. If a retry reaches the receiver
151
+ after the caller timed out, asynchronous `message/send` returns the existing
152
+ active or completed task instead of starting a duplicate agent run. Failed and
153
+ canceled tasks release the key for an intentional retry; synchronous calls are
154
+ never deduplicated. Lower-level clients may pass an
155
+ `idempotencyKey` explicitly; keep it stable for the same logical submission and
156
+ change it when the work changes. Dedupe is scoped to the JWT-authenticated
157
+ owner and verified org, and keys are limited to 128 characters.
158
+
159
+ The caller also forwards bounded correlation metadata (`callerApp`,
160
+ `callerThreadId`, `parentRunId`, `parentTurnId`, and direct-read
161
+ `invocationId`). These fields
162
+ are telemetry hints only. Receivers must continue to derive identity,
163
+ ownership, org scope, access, and approval from the verified request context.
164
+ Delegated model loops emit `$ai_generation` with A2A/MCP lineage, while direct
165
+ reads emit the content-free `$a2a_read_invoke` event; neither event includes
166
+ action arguments or results.
167
+
147
168
  ### Advanced: `A2AClient` (full control)
148
169
 
149
170
  ```ts
@@ -285,7 +285,13 @@ LLM generation:
285
285
  - Agent Native Analytics shape: the same event lands in `analytics_events` with
286
286
  mirrored query-friendly properties such as `run_id`, `thread_id`,
287
287
  `cost_cents_x100`, `duration_ms`, `tool_calls`, `successful_tools`,
288
- `failed_tools`, and `status`.
288
+ `failed_tools`, and `status`. A content-free `tools` array includes at most
289
+ 50 tool names, start offsets, durations, statuses, and coarse error classes;
290
+ interrupted calls are finalized as errors, and failed runs still emit with
291
+ zero or known usage. `tools_truncated` marks longer runs while the rollup counts remain complete.
292
+ Delegated runs add `delegation_protocol`, `caller_app`, `a2a_task_id`, and
293
+ `parent_run_id` when available. `parent_turn_id` is separate because one
294
+ logical turn may span multiple concrete runs.
289
295
 
290
296
  Do not build a separate LLM-observability ingestion API unless there is a clear
291
297
  reason the tracking provider registry cannot express the use case. Keep prompt,
@@ -141,7 +141,7 @@ Other framework-level baseline events:
141
141
  - `signup` from Better Auth user creation, with `auth_provider`, `auth_user_id`, and first-touch referral attribution (`referral_source`, `referrer_user`, `referral_medium`, `referral_campaign`, `utm_*`, `first_touch_path`, `landing_referrer` — see "Referral / viral attribution" above)
142
142
  - `builder connect clicked` and `builder connect popup blocked` from browser Connect Builder CTAs
143
143
  - `builder connect started`, `builder connect succeeded`, `builder connect failed`, `builder disconnect succeeded`, and `builder disconnect failed` from the Builder connection routes, with LLM connection context when resolvable
144
- - `$ai_generation` from instrumented agent loops, with PostHog AI Observability fields such as `$ai_trace_id`, `$ai_session_id`, `$ai_model`, `$ai_provider`, `$ai_input_tokens`, `$ai_output_tokens`, `$ai_latency`, `$ai_total_cost_usd`, and mirrored Agent Native query fields such as `run_id`, `thread_id`, `cost_cents_x100`, `duration_ms`, `tool_calls`, and `status`. Prompt, tool argument, and output content is not included by default.
144
+ - `$ai_generation` from instrumented agent loops, with PostHog AI Observability fields such as `$ai_trace_id`, `$ai_session_id`, `$ai_model`, `$ai_provider`, `$ai_input_tokens`, `$ai_output_tokens`, `$ai_latency`, `$ai_total_cost_usd`, and mirrored Agent Native query fields such as `run_id`, `thread_id`, `cost_cents_x100`, `duration_ms`, `tool_calls`, and `status`. A bounded `tools` array contains names, start offsets, durations, statuses, and coarse error classes only; interrupted tools and failed runs remain visible, and delegated runs include protocol/task/parent-run/parent-turn correlation. Prompt, tool argument, result, and output content is excluded.
145
145
 
146
146
  For new lifecycle events, call `track()` server-side when the server is the source of truth, and `trackEvent()` client-side only for browser interactions.
147
147
 
@@ -35,263 +35,213 @@ or administrator policy can prevent a generic one-click connection.
35
35
 
36
36
  ## The integration wall {#integration-wall}
37
37
 
38
- These compact, self-hosted wordmarks keep the directory fast and deployable
39
- without a third-party logo CDN. The labels and status pills come from the same
40
- shipped MCP preset categories documented below.
38
+ These self-hosted provider marks keep the directory fast and deployable
39
+ without a third-party logo CDN. Connection details and status categories remain
40
+ in the directory table below.
41
41
 
42
- <Diagram id="doc-block-integrations-wall" title="Remote MCP integrations" summary="A self-hosted logo wall of the 25 remote MCP presets currently shipped in the Agent-Native framework." frame="hide">
42
+ <Diagram id="doc-block-integrations-wall" title="Remote MCP integrations" summary="A self-hosted logo wall of the 25 remote MCP presets currently shipped in the Agent-Native framework." frame="hide" renderMode="design">
43
43
 
44
44
  ```html
45
45
  <div class="integration-wall">
46
46
  <div class="integration-card">
47
47
  <div class="integration-head">
48
- <span class="integration-mark c7">C7</span>
48
+ <span class="integration-mark"
49
+ ><img src="/integration-logos/context7.svg" alt=""
50
+ /></span>
49
51
  <div><strong>Context7</strong><small>Docs &amp; reference</small></div>
50
52
  </div>
51
- <div class="integration-tags">
52
- <span class="integration-tag direct">No auth</span
53
- ><span class="integration-tag ready">Verified</span>
54
- </div>
55
53
  </div>
56
54
  <div class="integration-card">
57
55
  <div class="integration-head">
58
- <span class="integration-mark sentry">S</span>
56
+ <span class="integration-mark"
57
+ ><img src="/integration-logos/sentry.svg" alt=""
58
+ /></span>
59
59
  <div><strong>Sentry</strong><small>Errors &amp; debugging</small></div>
60
60
  </div>
61
- <div class="integration-tags">
62
- <span class="integration-tag token">Header / token</span
63
- ><span class="integration-tag ready">Ready</span>
64
- </div>
65
61
  </div>
66
62
  <div class="integration-card">
67
63
  <div class="integration-head">
68
- <span class="integration-mark notion">N</span>
64
+ <span class="integration-mark"
65
+ ><img src="/integration-logos/notion.svg" alt=""
66
+ /></span>
69
67
  <div><strong>Notion</strong><small>Knowledge &amp; docs</small></div>
70
68
  </div>
71
- <div class="integration-tags">
72
- <span class="integration-tag oauth">OAuth</span
73
- ><span class="integration-tag ready">Ready</span>
74
- </div>
75
69
  </div>
76
70
  <div class="integration-card">
77
71
  <div class="integration-head">
78
- <span class="integration-mark semgrep">SG</span>
72
+ <span class="integration-mark"
73
+ ><img src="/integration-logos/semgrep.svg" alt=""
74
+ /></span>
79
75
  <div><strong>Semgrep</strong><small>Security scanning</small></div>
80
76
  </div>
81
- <div class="integration-tags">
82
- <span class="integration-tag direct">No auth</span
83
- ><span class="integration-tag ready">Ready</span>
84
- </div>
85
77
  </div>
86
78
  <div class="integration-card">
87
79
  <div class="integration-head">
88
- <span class="integration-mark linear">L</span>
80
+ <span class="integration-mark"
81
+ ><img src="/integration-logos/linear.svg" alt=""
82
+ /></span>
89
83
  <div><strong>Linear</strong><small>Issues &amp; planning</small></div>
90
84
  </div>
91
- <div class="integration-tags">
92
- <span class="integration-tag oauth">OAuth</span
93
- ><span class="integration-tag ready">Ready</span>
94
- </div>
95
85
  </div>
96
86
  <div class="integration-card">
97
87
  <div class="integration-head">
98
- <span class="integration-mark atlassian">A</span>
88
+ <span class="integration-mark"
89
+ ><img src="/integration-logos/atlassian.svg" alt=""
90
+ /></span>
99
91
  <div><strong>Atlassian</strong><small>Jira &amp; Confluence</small></div>
100
92
  </div>
101
- <div class="integration-tags">
102
- <span class="integration-tag oauth">OAuth</span
103
- ><span class="integration-tag restricted">Restricted</span>
104
- </div>
105
93
  </div>
106
94
  <div class="integration-card">
107
95
  <div class="integration-head">
108
- <span class="integration-mark supabase">SB</span>
96
+ <span class="integration-mark"
97
+ ><img src="/integration-logos/supabase.svg" alt=""
98
+ /></span>
109
99
  <div><strong>Supabase</strong><small>Database &amp; auth</small></div>
110
100
  </div>
111
- <div class="integration-tags">
112
- <span class="integration-tag oauth">OAuth</span
113
- ><span class="integration-tag ready">Ready</span>
114
- </div>
115
101
  </div>
116
102
  <div class="integration-card">
117
103
  <div class="integration-head">
118
- <span class="integration-mark neon">N</span>
104
+ <span class="integration-mark"
105
+ ><img src="/integration-logos/neon.svg" alt=""
106
+ /></span>
119
107
  <div><strong>Neon</strong><small>Serverless Postgres</small></div>
120
108
  </div>
121
- <div class="integration-tags">
122
- <span class="integration-tag oauth">OAuth</span
123
- ><span class="integration-tag ready">Ready</span>
124
- </div>
125
109
  </div>
126
110
  <div class="integration-card">
127
111
  <div class="integration-head">
128
- <span class="integration-mark stripe">S</span>
112
+ <span class="integration-mark"
113
+ ><img src="/integration-logos/stripe.svg" alt=""
114
+ /></span>
129
115
  <div><strong>Stripe</strong><small>Payments &amp; billing</small></div>
130
116
  </div>
131
- <div class="integration-tags">
132
- <span class="integration-tag oauth">OAuth</span
133
- ><span class="integration-tag ready">Ready</span>
134
- </div>
135
117
  </div>
136
118
  <div class="integration-card">
137
119
  <div class="integration-head">
138
- <span class="integration-mark cloudflare">CF</span>
120
+ <span class="integration-mark"
121
+ ><img src="/integration-logos/cloudflare.svg" alt=""
122
+ /></span>
139
123
  <div><strong>Cloudflare</strong><small>Cloud &amp; security</small></div>
140
124
  </div>
141
- <div class="integration-tags">
142
- <span class="integration-tag oauth">OAuth</span
143
- ><span class="integration-tag ready">Ready</span>
144
- </div>
145
125
  </div>
146
126
  <div class="integration-card">
147
127
  <div class="integration-head">
148
- <span class="integration-mark gitlab">GL</span>
128
+ <span class="integration-mark"
129
+ ><img src="/integration-logos/gitlab.svg" alt=""
130
+ /></span>
149
131
  <div><strong>GitLab</strong><small>Repos &amp; CI/CD</small></div>
150
132
  </div>
151
- <div class="integration-tags">
152
- <span class="integration-tag oauth">OAuth</span
153
- ><span class="integration-tag restricted">Beta / restricted</span>
154
- </div>
155
133
  </div>
156
134
  <div class="integration-card">
157
135
  <div class="integration-head">
158
- <span class="integration-mark figma">F</span>
136
+ <span class="integration-mark"
137
+ ><img src="/integration-logos/figma.svg" alt=""
138
+ /></span>
159
139
  <div><strong>Figma</strong><small>Design context</small></div>
160
140
  </div>
161
- <div class="integration-tags">
162
- <span class="integration-tag manual">Manual setup</span
163
- ><span class="integration-tag restricted">Approved clients</span>
164
- </div>
165
141
  </div>
166
142
  <div class="integration-card">
167
143
  <div class="integration-head">
168
- <span class="integration-mark canva">C</span>
144
+ <span class="integration-mark"
145
+ ><img src="/integration-logos/canva.svg" alt=""
146
+ /></span>
169
147
  <div><strong>Canva</strong><small>Designs &amp; assets</small></div>
170
148
  </div>
171
- <div class="integration-tags">
172
- <span class="integration-tag manual">Manual setup</span
173
- ><span class="integration-tag restricted">Approved domains</span>
174
- </div>
175
149
  </div>
176
150
  <div class="integration-card">
177
151
  <div class="integration-head">
178
- <span class="integration-mark vercel">V</span>
152
+ <span class="integration-mark"
153
+ ><img src="/integration-logos/vercel.svg" alt=""
154
+ /></span>
179
155
  <div><strong>Vercel</strong><small>Deployments &amp; logs</small></div>
180
156
  </div>
181
- <div class="integration-tags">
182
- <span class="integration-tag manual">Manual setup</span
183
- ><span class="integration-tag restricted">Approved clients</span>
184
- </div>
185
157
  </div>
186
158
  <div class="integration-card">
187
159
  <div class="integration-head">
188
- <span class="integration-mark github">GH</span>
160
+ <span class="integration-mark"
161
+ ><img src="/integration-logos/github.svg" alt=""
162
+ /></span>
189
163
  <div><strong>GitHub</strong><small>Code &amp; pull requests</small></div>
190
164
  </div>
191
- <div class="integration-tags">
192
- <span class="integration-tag manual">Manual setup</span
193
- ><span class="integration-tag restricted">Provider setup</span>
194
- </div>
195
165
  </div>
196
166
  <div class="integration-card">
197
167
  <div class="integration-head">
198
- <span class="integration-mark slack">#</span>
168
+ <span class="integration-mark"
169
+ ><img src="/integration-logos/slack.svg" alt=""
170
+ /></span>
199
171
  <div><strong>Slack</strong><small>Messages &amp; channels</small></div>
200
172
  </div>
201
- <div class="integration-tags">
202
- <span class="integration-tag manual">Manual setup</span
203
- ><span class="integration-tag restricted">Approved clients</span>
204
- </div>
205
173
  </div>
206
174
  <div class="integration-card">
207
175
  <div class="integration-head">
208
- <span class="integration-mark asana">AS</span>
176
+ <span class="integration-mark"
177
+ ><img src="/integration-logos/asana.svg" alt=""
178
+ /></span>
209
179
  <div><strong>Asana</strong><small>Tasks &amp; projects</small></div>
210
180
  </div>
211
- <div class="integration-tags">
212
- <span class="integration-tag manual">Manual setup</span
213
- ><span class="integration-tag restricted">Provider setup</span>
214
- </div>
215
181
  </div>
216
182
  <div class="integration-card">
217
183
  <div class="integration-head">
218
- <span class="integration-mark hubspot">HS</span>
184
+ <span class="integration-mark"
185
+ ><img src="/integration-logos/hubspot.svg" alt=""
186
+ /></span>
219
187
  <div><strong>HubSpot</strong><small>CRM &amp; customer data</small></div>
220
188
  </div>
221
- <div class="integration-tags">
222
- <span class="integration-tag manual">Manual setup</span
223
- ><span class="integration-tag restricted">Provider setup</span>
224
- </div>
225
189
  </div>
226
190
  <div class="integration-card">
227
191
  <div class="integration-head">
228
- <span class="integration-mark intercom">I</span>
192
+ <span class="integration-mark"
193
+ ><img src="/integration-logos/intercom.svg" alt=""
194
+ /></span>
229
195
  <div><strong>Intercom</strong><small>Support conversations</small></div>
230
196
  </div>
231
- <div class="integration-tags">
232
- <span class="integration-tag oauth">OAuth</span
233
- ><span class="integration-tag ready">Ready</span>
234
- </div>
235
197
  </div>
236
198
  <div class="integration-card">
237
199
  <div class="integration-head">
238
- <span class="integration-mark monday">M</span>
200
+ <span class="integration-mark"
201
+ ><img src="/integration-logos/monday.svg" alt=""
202
+ /></span>
239
203
  <div><strong>monday.com</strong><small>Work management</small></div>
240
204
  </div>
241
- <div class="integration-tags">
242
- <span class="integration-tag oauth">OAuth</span
243
- ><span class="integration-tag ready">Ready</span>
244
- </div>
245
205
  </div>
246
206
  <div class="integration-card">
247
207
  <div class="integration-head">
248
- <span class="integration-mark webflow">W</span>
208
+ <span class="integration-mark"
209
+ ><img src="/integration-logos/webflow.svg" alt=""
210
+ /></span>
249
211
  <div><strong>Webflow</strong><small>Websites &amp; CMS</small></div>
250
212
  </div>
251
- <div class="integration-tags">
252
- <span class="integration-tag oauth">OAuth</span
253
- ><span class="integration-tag ready">Ready</span>
254
- </div>
255
213
  </div>
256
214
  <div class="integration-card">
257
215
  <div class="integration-head">
258
- <span class="integration-mark paypal">PP</span>
216
+ <span class="integration-mark"
217
+ ><img src="/integration-logos/paypal.svg" alt=""
218
+ /></span>
259
219
  <div><strong>PayPal</strong><small>Commerce &amp; invoices</small></div>
260
220
  </div>
261
- <div class="integration-tags">
262
- <span class="integration-tag oauth">OAuth</span
263
- ><span class="integration-tag ready">Ready</span>
264
- </div>
265
221
  </div>
266
222
  <div class="integration-card">
267
223
  <div class="integration-head">
268
- <span class="integration-mark box">B</span>
224
+ <span class="integration-mark"
225
+ ><img src="/integration-logos/box.svg" alt=""
226
+ /></span>
269
227
  <div><strong>Box</strong><small>Files &amp; folders</small></div>
270
228
  </div>
271
- <div class="integration-tags">
272
- <span class="integration-tag manual">Manual setup</span
273
- ><span class="integration-tag restricted">Beta / restricted</span>
274
- </div>
275
229
  </div>
276
230
  <div class="integration-card">
277
231
  <div class="integration-head">
278
- <span class="integration-mark netlify">N</span>
232
+ <span class="integration-mark"
233
+ ><img src="/integration-logos/netlify.svg" alt=""
234
+ /></span>
279
235
  <div><strong>Netlify</strong><small>Sites &amp; builds</small></div>
280
236
  </div>
281
- <div class="integration-tags">
282
- <span class="integration-tag oauth">OAuth</span
283
- ><span class="integration-tag ready">Ready</span>
284
- </div>
285
237
  </div>
286
238
  <div class="integration-card">
287
239
  <div class="integration-head">
288
- <span class="integration-mark zapier">Z</span>
240
+ <span class="integration-mark"
241
+ ><img src="/integration-logos/zapier.svg" alt=""
242
+ /></span>
289
243
  <div><strong>Zapier</strong><small>Automation actions</small></div>
290
244
  </div>
291
- <div class="integration-tags">
292
- <span class="integration-tag token">Header / token</span
293
- ><span class="integration-tag restricted">User server</span>
294
- </div>
295
245
  </div>
296
246
  </div>
297
247
  ```
@@ -304,9 +254,8 @@ shipped MCP preset categories documented below.
304
254
  }
305
255
  .integration-card {
306
256
  display: flex;
307
- flex-direction: column;
308
- gap: 12px;
309
- min-height: 118px;
257
+ align-items: center;
258
+ min-height: 70px;
310
259
  padding: 14px;
311
260
  border: 1px solid var(--wf-line);
312
261
  border-radius: 12px;
@@ -343,128 +292,13 @@ shipped MCP preset categories documented below.
343
292
  height: 38px;
344
293
  flex: none;
345
294
  border-radius: 10px;
346
- color: #fff;
347
- font-size: 11px;
348
- font-weight: 800;
349
- letter-spacing: -0.04em;
350
- }
351
- .c7 {
352
- background: #1f6feb;
353
- }
354
- .sentry {
355
- background: #5b35d5;
356
- }
357
- .notion {
358
- background: #111;
359
- }
360
- .semgrep {
361
- background: #0d8b76;
362
- }
363
- .linear {
364
- background: #5e5ce6;
365
- }
366
- .atlassian {
367
- background: #1868db;
368
- }
369
- .supabase {
370
- background: #3ecf8e;
371
- color: #062b1a;
372
- }
373
- .neon {
374
- background: #00e5a0;
375
- color: #062b1a;
376
- }
377
- .stripe {
378
- background: #635bff;
379
- }
380
- .cloudflare {
381
- background: #f38020;
382
- }
383
- .gitlab {
384
- background: #fc6d26;
385
- }
386
- .figma {
387
- background: #f24e1e;
388
- }
389
- .canva {
390
- background: #00c4cc;
391
- color: #053b40;
392
- }
393
- .vercel {
394
- background: #111;
395
- }
396
- .github {
397
- background: #24292f;
398
- }
399
- .slack {
400
- background: #36c5f0;
401
- color: #082c3b;
402
- }
403
- .asana {
404
- background: #f06a6a;
405
- }
406
- .hubspot {
407
- background: #ff7a59;
408
- }
409
- .intercom {
410
- background: #286efa;
411
- }
412
- .monday {
413
- background: #6161ff;
414
- }
415
- .webflow {
416
- background: #146ef5;
417
- }
418
- .paypal {
419
- background: #003087;
420
- }
421
- .box {
422
- background: #0061d5;
423
- }
424
- .netlify {
425
- background: #05bdbb;
426
- color: #062b2b;
427
- }
428
- .zapier {
429
- background: #ff4f00;
430
- }
431
- .integration-tags {
432
- display: flex;
433
- flex-wrap: wrap;
434
- gap: 5px;
435
- margin-top: auto;
436
- }
437
- .integration-tag {
438
- padding: 4px 7px;
439
- border-radius: 999px;
440
- background: var(--wf-line);
441
- color: var(--wf-muted);
442
- font-size: 10px;
443
- line-height: 1;
444
- }
445
- .integration-tag.oauth {
446
- background: #e8e7ff;
447
- color: #4438a8;
448
- }
449
- .integration-tag.manual {
450
- background: #fff0d6;
451
- color: #8a5200;
452
- }
453
- .integration-tag.token {
454
- background: #e5f3ff;
455
- color: #075985;
456
- }
457
- .integration-tag.direct {
458
- background: #e1f7ee;
459
- color: #146c4b;
460
- }
461
- .integration-tag.ready {
462
- background: #e1f7ee;
463
- color: #146c4b;
295
+ background: #fff;
296
+ box-shadow: inset 0 0 0 1px rgba(15, 23, 42, 0.08);
464
297
  }
465
- .integration-tag.restricted {
466
- background: #ffe4e6;
467
- color: #9f1239;
298
+ .integration-mark img {
299
+ width: 26px;
300
+ height: 26px;
301
+ object-fit: contain;
468
302
  }
469
303
  @media (max-width: 760px) {
470
304
  .integration-wall {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@agent-native/core",
3
- "version": "0.109.0",
3
+ "version": "0.109.2",
4
4
  "description": "Framework for agent-native application development — where AI agents and UI share SQL state, actions, and context",
5
5
  "homepage": "https://github.com/BuilderIO/agent-native#readme",
6
6
  "bugs": {
@@ -144,6 +144,27 @@ message delegation for planning, synthesis, multi-step work, or mutations.
144
144
  Inside an agent loop, `call-agent` exposes the same path with `action` + `input`;
145
145
  omit `message` and `taskId` in that mode.
146
146
 
147
+ ### Retry safety and trace linkage
148
+
149
+ `call-agent` automatically derives an owner-scoped idempotency key from the
150
+ originating turn, target, and exact message. If a retry reaches the receiver
151
+ after the caller timed out, asynchronous `message/send` returns the existing
152
+ active or completed task instead of starting a duplicate agent run. Failed and
153
+ canceled tasks release the key for an intentional retry; synchronous calls are
154
+ never deduplicated. Lower-level clients may pass an
155
+ `idempotencyKey` explicitly; keep it stable for the same logical submission and
156
+ change it when the work changes. Dedupe is scoped to the JWT-authenticated
157
+ owner and verified org, and keys are limited to 128 characters.
158
+
159
+ The caller also forwards bounded correlation metadata (`callerApp`,
160
+ `callerThreadId`, `parentRunId`, `parentTurnId`, and direct-read
161
+ `invocationId`). These fields
162
+ are telemetry hints only. Receivers must continue to derive identity,
163
+ ownership, org scope, access, and approval from the verified request context.
164
+ Delegated model loops emit `$ai_generation` with A2A/MCP lineage, while direct
165
+ reads emit the content-free `$a2a_read_invoke` event; neither event includes
166
+ action arguments or results.
167
+
147
168
  ### Advanced: `A2AClient` (full control)
148
169
 
149
170
  ```ts
@@ -285,7 +285,13 @@ LLM generation:
285
285
  - Agent Native Analytics shape: the same event lands in `analytics_events` with
286
286
  mirrored query-friendly properties such as `run_id`, `thread_id`,
287
287
  `cost_cents_x100`, `duration_ms`, `tool_calls`, `successful_tools`,
288
- `failed_tools`, and `status`.
288
+ `failed_tools`, and `status`. A content-free `tools` array includes at most
289
+ 50 tool names, start offsets, durations, statuses, and coarse error classes;
290
+ interrupted calls are finalized as errors, and failed runs still emit with
291
+ zero or known usage. `tools_truncated` marks longer runs while the rollup counts remain complete.
292
+ Delegated runs add `delegation_protocol`, `caller_app`, `a2a_task_id`, and
293
+ `parent_run_id` when available. `parent_turn_id` is separate because one
294
+ logical turn may span multiple concrete runs.
289
295
 
290
296
  Do not build a separate LLM-observability ingestion API unless there is a clear
291
297
  reason the tracking provider registry cannot express the use case. Keep prompt,
@@ -141,7 +141,7 @@ Other framework-level baseline events:
141
141
  - `signup` from Better Auth user creation, with `auth_provider`, `auth_user_id`, and first-touch referral attribution (`referral_source`, `referrer_user`, `referral_medium`, `referral_campaign`, `utm_*`, `first_touch_path`, `landing_referrer` — see "Referral / viral attribution" above)
142
142
  - `builder connect clicked` and `builder connect popup blocked` from browser Connect Builder CTAs
143
143
  - `builder connect started`, `builder connect succeeded`, `builder connect failed`, `builder disconnect succeeded`, and `builder disconnect failed` from the Builder connection routes, with LLM connection context when resolvable
144
- - `$ai_generation` from instrumented agent loops, with PostHog AI Observability fields such as `$ai_trace_id`, `$ai_session_id`, `$ai_model`, `$ai_provider`, `$ai_input_tokens`, `$ai_output_tokens`, `$ai_latency`, `$ai_total_cost_usd`, and mirrored Agent Native query fields such as `run_id`, `thread_id`, `cost_cents_x100`, `duration_ms`, `tool_calls`, and `status`. Prompt, tool argument, and output content is not included by default.
144
+ - `$ai_generation` from instrumented agent loops, with PostHog AI Observability fields such as `$ai_trace_id`, `$ai_session_id`, `$ai_model`, `$ai_provider`, `$ai_input_tokens`, `$ai_output_tokens`, `$ai_latency`, `$ai_total_cost_usd`, and mirrored Agent Native query fields such as `run_id`, `thread_id`, `cost_cents_x100`, `duration_ms`, `tool_calls`, and `status`. A bounded `tools` array contains names, start offsets, durations, statuses, and coarse error classes only; interrupted tools and failed runs remain visible, and delegated runs include protocol/task/parent-run/parent-turn correlation. Prompt, tool argument, result, and output content is excluded.
145
145
 
146
146
  For new lifecycle events, call `track()` server-side when the server is the source of truth, and `trackEvent()` client-side only for browser interactions.
147
147