@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.
- package/corpus/README.md +2 -2
- package/corpus/core/CHANGELOG.md +14 -0
- package/corpus/core/docs/content/integrations.mdx +87 -253
- package/corpus/core/package.json +1 -1
- package/corpus/core/src/a2a/client.ts +24 -2
- package/corpus/core/src/a2a/correlation.ts +50 -0
- package/corpus/core/src/a2a/handlers.ts +140 -14
- package/corpus/core/src/a2a/index.ts +1 -0
- package/corpus/core/src/a2a/invoke.ts +10 -1
- package/corpus/core/src/a2a/task-store.ts +146 -6
- package/corpus/core/src/a2a/types.ts +16 -0
- package/corpus/core/src/action.ts +2 -0
- package/corpus/core/src/agent/production-agent.ts +23 -0
- package/corpus/core/src/client/blocks/library/diagram.config.ts +10 -1
- package/corpus/core/src/client/blocks/library/diagram.tsx +9 -4
- package/corpus/core/src/client/use-run-stuck-detection.ts +27 -1
- package/corpus/core/src/db/client.ts +55 -0
- package/corpus/core/src/deploy/build.ts +63 -3
- package/corpus/core/src/observability/traces.ts +172 -19
- package/corpus/core/src/scripts/call-agent.ts +53 -2
- package/corpus/core/src/server/agent-chat/action-filters-a2a.ts +72 -25
- package/corpus/core/src/server/agent-chat-plugin.ts +107 -6
- package/corpus/core/src/templates/workspace-core/.agents/skills/a2a-protocol/SKILL.md +21 -0
- package/corpus/core/src/templates/workspace-core/.agents/skills/observability/SKILL.md +7 -1
- package/corpus/core/src/templates/workspace-core/.agents/skills/tracking/SKILL.md +1 -1
- package/corpus/templates/analytics/actions/query-agent-native-analytics.ts +1 -1
- package/corpus/templates/analytics/changelog/2026-07-17-analytics-now-includes-a-default-alert-for-spikes-in-stuck-agent-chats.md +6 -0
- package/corpus/templates/analytics/docs/schemas/first-party-analytics.md +23 -14
- package/corpus/templates/analytics/docs/schemas/tracked-events.md +5 -1
- package/corpus/templates/analytics/server/jobs/analytics-alerts.ts +3 -3
- package/corpus/templates/analytics/server/lib/analytics-alerts.ts +209 -87
- package/corpus/templates/clips/.agents/skills/dictate/SKILL.md +28 -5
- package/corpus/templates/clips/.agents/skills/meetings/SKILL.md +7 -0
- package/corpus/templates/clips/.agents/skills/recording/SKILL.md +23 -0
- package/corpus/templates/clips/AGENTS.md +10 -0
- package/corpus/templates/clips/actions/create-dictation.ts +29 -4
- package/corpus/templates/clips/actions/finalize-recording.ts +542 -65
- package/corpus/templates/clips/actions/get-recording-player-data.ts +16 -6
- package/corpus/templates/clips/actions/set-mobile-capture-state.ts +37 -0
- package/corpus/templates/clips/actions/update-dictation.ts +9 -1
- package/corpus/templates/clips/app/components/player/playback-comment-overlay.tsx +17 -2
- package/corpus/templates/clips/app/components/player/video-player.tsx +14 -2
- package/corpus/templates/clips/app/components/recorder/recorder-engine.ts +2 -2
- package/corpus/templates/clips/app/routes/r.$recordingId.tsx +14 -3
- package/corpus/templates/clips/app/routes/record.tsx +3 -3
- package/corpus/templates/clips/app/routes/share.$shareId.tsx +19 -5
- package/corpus/templates/clips/changelog/2026-07-17-capture-dictation-background-meeting-audio-and-camera-videos.md +6 -0
- package/corpus/templates/clips/changelog/2026-07-17-clips-now-retries-storage-verification-in-the-background-ins.md +6 -0
- package/corpus/templates/clips/changelog/2026-07-17-delayed-upload-verification-keeps-local-backups-retryable.md +6 -0
- package/corpus/templates/clips/changelog/2026-07-17-fixed-broken-thumbnail-icons-appearing-over-playable-clip-em.md +6 -0
- package/corpus/templates/clips/changelog/2026-07-17-playback-comments-stay-readable-at-faster-playback-speeds.md +6 -0
- package/corpus/templates/clips/chrome-extension/src/finalize-recovery.ts +3 -0
- package/corpus/templates/clips/chrome-extension/src/offscreen.ts +3 -3
- package/corpus/templates/clips/desktop/src/app.tsx +35 -6
- package/corpus/templates/clips/desktop/src/lib/processing-backup-recovery.ts +19 -0
- package/corpus/templates/clips/desktop/src/lib/recorder.ts +141 -18
- package/corpus/templates/clips/desktop/src/lib/upload-verification.ts +28 -7
- package/corpus/templates/clips/desktop/src-tauri/src/lib.rs +3 -4
- package/corpus/templates/clips/desktop/src-tauri/src/native_screen/live_upload.rs +32 -15
- package/corpus/templates/clips/desktop/src-tauri/src/native_screen.rs +59 -18
- package/corpus/templates/clips/server/db/schema.ts +9 -1
- package/corpus/templates/clips/server/jobs/media-verification.ts +130 -0
- package/corpus/templates/clips/server/lib/builder-media-compression.ts +74 -7
- package/corpus/templates/clips/server/lib/media-verification-state.ts +55 -0
- package/corpus/templates/clips/server/lib/player-thumbnail-url.ts +31 -0
- package/corpus/templates/clips/server/lib/post-finalize-dispatch.ts +10 -3
- package/corpus/templates/clips/server/plugins/auth.ts +5 -5
- package/corpus/templates/clips/server/plugins/calendar-jobs.ts +2 -0
- package/corpus/templates/clips/server/routes/api/_agent-native-background/post-finalize-worker.post.ts +12 -2
- package/corpus/templates/clips/server/routes/api/public-recording.get.ts +13 -1
- package/corpus/templates/clips/server/routes/api/thumbnail/[recordingId].get.ts +340 -0
- package/corpus/templates/clips/server/routes/api/uploads/[recordingId]/abort.post.ts +24 -7
- package/corpus/templates/clips/server/routes/api/uploads/[recordingId]/chunk.post.ts +91 -7
- package/corpus/templates/clips/server/routes/api/uploads/[recordingId]/reset-chunks.post.ts +22 -1
- package/corpus/templates/clips/server/routes/api/uploads/[recordingId]/status.get.ts +14 -0
- package/corpus/templates/clips/shared/finalize-recovery.ts +61 -2
- package/corpus/templates/clips/shared/share-meta.ts +1 -1
- package/corpus/templates/plan/changelog/2026-07-17-diagrams-can-opt-into-a-polished-clean-rendering-mode-withou.md +6 -0
- package/corpus/templates/plan/shared/plan-content.ts +3 -0
- package/dist/a2a/client.d.ts +11 -2
- package/dist/a2a/client.d.ts.map +1 -1
- package/dist/a2a/client.js +16 -3
- package/dist/a2a/client.js.map +1 -1
- package/dist/a2a/correlation.d.ts +10 -0
- package/dist/a2a/correlation.d.ts.map +1 -0
- package/dist/a2a/correlation.js +40 -0
- package/dist/a2a/correlation.js.map +1 -0
- package/dist/a2a/handlers.d.ts.map +1 -1
- package/dist/a2a/handlers.js +100 -15
- package/dist/a2a/handlers.js.map +1 -1
- package/dist/a2a/index.d.ts +1 -1
- package/dist/a2a/index.d.ts.map +1 -1
- package/dist/a2a/index.js.map +1 -1
- package/dist/a2a/invoke.d.ts +4 -1
- package/dist/a2a/invoke.d.ts.map +1 -1
- package/dist/a2a/invoke.js +3 -0
- package/dist/a2a/invoke.js.map +1 -1
- package/dist/a2a/task-store.d.ts +12 -1
- package/dist/a2a/task-store.d.ts.map +1 -1
- package/dist/a2a/task-store.js +96 -6
- package/dist/a2a/task-store.js.map +1 -1
- package/dist/a2a/types.d.ts +15 -0
- package/dist/a2a/types.d.ts.map +1 -1
- package/dist/a2a/types.js.map +1 -1
- package/dist/action.d.ts +2 -0
- package/dist/action.d.ts.map +1 -1
- package/dist/action.js.map +1 -1
- package/dist/agent/production-agent.d.ts +9 -0
- package/dist/agent/production-agent.d.ts.map +1 -1
- package/dist/agent/production-agent.js +14 -0
- package/dist/agent/production-agent.js.map +1 -1
- package/dist/client/blocks/library/diagram.config.d.ts +2 -0
- package/dist/client/blocks/library/diagram.config.d.ts.map +1 -1
- package/dist/client/blocks/library/diagram.config.js +8 -1
- package/dist/client/blocks/library/diagram.config.js.map +1 -1
- package/dist/client/blocks/library/diagram.d.ts.map +1 -1
- package/dist/client/blocks/library/diagram.js +9 -4
- package/dist/client/blocks/library/diagram.js.map +1 -1
- package/dist/client/use-run-stuck-detection.d.ts.map +1 -1
- package/dist/client/use-run-stuck-detection.js +25 -1
- package/dist/client/use-run-stuck-detection.js.map +1 -1
- package/dist/collab/routes.d.ts +1 -1
- package/dist/db/client.d.ts +7 -0
- package/dist/db/client.d.ts.map +1 -1
- package/dist/db/client.js +33 -0
- package/dist/db/client.js.map +1 -1
- package/dist/deploy/build.d.ts +3 -0
- package/dist/deploy/build.d.ts.map +1 -1
- package/dist/deploy/build.js +45 -1
- package/dist/deploy/build.js.map +1 -1
- package/dist/observability/routes.d.ts +1 -1
- package/dist/observability/traces.d.ts +9 -0
- package/dist/observability/traces.d.ts.map +1 -1
- package/dist/observability/traces.js +137 -19
- package/dist/observability/traces.js.map +1 -1
- package/dist/progress/routes.d.ts +1 -1
- package/dist/scripts/call-agent.d.ts.map +1 -1
- package/dist/scripts/call-agent.js +35 -3
- package/dist/scripts/call-agent.js.map +1 -1
- package/dist/server/agent-chat/action-filters-a2a.d.ts +18 -2
- package/dist/server/agent-chat/action-filters-a2a.d.ts.map +1 -1
- package/dist/server/agent-chat/action-filters-a2a.js +35 -7
- package/dist/server/agent-chat/action-filters-a2a.js.map +1 -1
- package/dist/server/agent-chat-plugin.d.ts.map +1 -1
- package/dist/server/agent-chat-plugin.js +93 -6
- package/dist/server/agent-chat-plugin.js.map +1 -1
- package/dist/templates/workspace-core/.agents/skills/a2a-protocol/SKILL.md +21 -0
- package/dist/templates/workspace-core/.agents/skills/observability/SKILL.md +7 -1
- package/dist/templates/workspace-core/.agents/skills/tracking/SKILL.md +1 -1
- package/docs/content/integrations.mdx +87 -253
- package/package.json +1 -1
- package/src/templates/workspace-core/.agents/skills/a2a-protocol/SKILL.md +21 -0
- package/src/templates/workspace-core/.agents/skills/observability/SKILL.md +7 -1
- 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
|
|
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
|
|
39
|
-
without a third-party logo CDN.
|
|
40
|
-
|
|
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
|
|
48
|
+
<span class="integration-mark"
|
|
49
|
+
><img src="/integration-logos/context7.svg" alt=""
|
|
50
|
+
/></span>
|
|
49
51
|
<div><strong>Context7</strong><small>Docs & 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
|
|
56
|
+
<span class="integration-mark"
|
|
57
|
+
><img src="/integration-logos/sentry.svg" alt=""
|
|
58
|
+
/></span>
|
|
59
59
|
<div><strong>Sentry</strong><small>Errors & 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
|
|
64
|
+
<span class="integration-mark"
|
|
65
|
+
><img src="/integration-logos/notion.svg" alt=""
|
|
66
|
+
/></span>
|
|
69
67
|
<div><strong>Notion</strong><small>Knowledge & 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
|
|
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
|
|
80
|
+
<span class="integration-mark"
|
|
81
|
+
><img src="/integration-logos/linear.svg" alt=""
|
|
82
|
+
/></span>
|
|
89
83
|
<div><strong>Linear</strong><small>Issues & 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
|
|
88
|
+
<span class="integration-mark"
|
|
89
|
+
><img src="/integration-logos/atlassian.svg" alt=""
|
|
90
|
+
/></span>
|
|
99
91
|
<div><strong>Atlassian</strong><small>Jira & 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
|
|
96
|
+
<span class="integration-mark"
|
|
97
|
+
><img src="/integration-logos/supabase.svg" alt=""
|
|
98
|
+
/></span>
|
|
109
99
|
<div><strong>Supabase</strong><small>Database & 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
|
|
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
|
|
112
|
+
<span class="integration-mark"
|
|
113
|
+
><img src="/integration-logos/stripe.svg" alt=""
|
|
114
|
+
/></span>
|
|
129
115
|
<div><strong>Stripe</strong><small>Payments & 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
|
|
120
|
+
<span class="integration-mark"
|
|
121
|
+
><img src="/integration-logos/cloudflare.svg" alt=""
|
|
122
|
+
/></span>
|
|
139
123
|
<div><strong>Cloudflare</strong><small>Cloud & 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
|
|
128
|
+
<span class="integration-mark"
|
|
129
|
+
><img src="/integration-logos/gitlab.svg" alt=""
|
|
130
|
+
/></span>
|
|
149
131
|
<div><strong>GitLab</strong><small>Repos & 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
|
|
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
|
|
144
|
+
<span class="integration-mark"
|
|
145
|
+
><img src="/integration-logos/canva.svg" alt=""
|
|
146
|
+
/></span>
|
|
169
147
|
<div><strong>Canva</strong><small>Designs & 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
|
|
152
|
+
<span class="integration-mark"
|
|
153
|
+
><img src="/integration-logos/vercel.svg" alt=""
|
|
154
|
+
/></span>
|
|
179
155
|
<div><strong>Vercel</strong><small>Deployments & 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
|
|
160
|
+
<span class="integration-mark"
|
|
161
|
+
><img src="/integration-logos/github.svg" alt=""
|
|
162
|
+
/></span>
|
|
189
163
|
<div><strong>GitHub</strong><small>Code & 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
|
|
168
|
+
<span class="integration-mark"
|
|
169
|
+
><img src="/integration-logos/slack.svg" alt=""
|
|
170
|
+
/></span>
|
|
199
171
|
<div><strong>Slack</strong><small>Messages & 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
|
|
176
|
+
<span class="integration-mark"
|
|
177
|
+
><img src="/integration-logos/asana.svg" alt=""
|
|
178
|
+
/></span>
|
|
209
179
|
<div><strong>Asana</strong><small>Tasks & 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
|
|
184
|
+
<span class="integration-mark"
|
|
185
|
+
><img src="/integration-logos/hubspot.svg" alt=""
|
|
186
|
+
/></span>
|
|
219
187
|
<div><strong>HubSpot</strong><small>CRM & 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
|
|
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
|
|
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
|
|
208
|
+
<span class="integration-mark"
|
|
209
|
+
><img src="/integration-logos/webflow.svg" alt=""
|
|
210
|
+
/></span>
|
|
249
211
|
<div><strong>Webflow</strong><small>Websites & 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
|
|
216
|
+
<span class="integration-mark"
|
|
217
|
+
><img src="/integration-logos/paypal.svg" alt=""
|
|
218
|
+
/></span>
|
|
259
219
|
<div><strong>PayPal</strong><small>Commerce & 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
|
|
224
|
+
<span class="integration-mark"
|
|
225
|
+
><img src="/integration-logos/box.svg" alt=""
|
|
226
|
+
/></span>
|
|
269
227
|
<div><strong>Box</strong><small>Files & 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
|
|
232
|
+
<span class="integration-mark"
|
|
233
|
+
><img src="/integration-logos/netlify.svg" alt=""
|
|
234
|
+
/></span>
|
|
279
235
|
<div><strong>Netlify</strong><small>Sites & 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
|
|
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
|
-
|
|
308
|
-
|
|
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
|
-
|
|
347
|
-
|
|
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-
|
|
466
|
-
|
|
467
|
-
|
|
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.
|
|
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
|
|
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
|
|