@cursor/july 0.1.41 → 0.1.43

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 (195) hide show
  1. package/AGENTS.md +10 -3
  2. package/dist/bin/agent-serve.js +3 -1
  3. package/dist/channels/github/api.d.ts +5 -0
  4. package/dist/channels/github/api.d.ts.map +1 -1
  5. package/dist/channels/github/api.js +18 -0
  6. package/dist/channels/github/defaults.d.ts +4 -5
  7. package/dist/channels/github/defaults.d.ts.map +1 -1
  8. package/dist/channels/github/defaults.js +27 -1
  9. package/dist/channels/github/github-channel.d.ts.map +1 -1
  10. package/dist/channels/github/github-channel.js +28 -5
  11. package/dist/channels/github/index.d.ts +1 -0
  12. package/dist/channels/github/index.d.ts.map +1 -1
  13. package/dist/channels/github/index.js +1 -0
  14. package/dist/channels/github/progress.d.ts +54 -0
  15. package/dist/channels/github/progress.d.ts.map +1 -0
  16. package/dist/channels/github/progress.js +168 -0
  17. package/dist/channels/github/state.d.ts +2 -0
  18. package/dist/channels/github/state.d.ts.map +1 -1
  19. package/dist/channels/github/state.js +1 -1
  20. package/dist/channels/github/types.d.ts +8 -4
  21. package/dist/channels/github/types.d.ts.map +1 -1
  22. package/dist/channels/slack/slack-channel.d.ts +4 -0
  23. package/dist/channels/slack/slack-channel.d.ts.map +1 -1
  24. package/dist/channels/slack/slack-channel.js +4 -0
  25. package/dist/docs/404.html +2 -2
  26. package/dist/docs/ab.html +4 -4
  27. package/dist/docs/assets/{app.mIw24pb1.js → app.DsTLo2j1.js} +1 -1
  28. package/dist/docs/assets/chunks/@localSearchIndexroot.BZx4pmZL.js +1 -0
  29. package/dist/docs/assets/chunks/{VPLocalSearchBox.hOzpPwrG.js → VPLocalSearchBox.DoVfutcV.js} +1 -1
  30. package/dist/docs/assets/chunks/{theme.BtFhUYmh.js → theme.DtuVtKkc.js} +2 -2
  31. package/dist/docs/assets/{deployment.md.BHVjVqRa.js → deployment.md.Cdp4rTE4.js} +1 -1
  32. package/dist/docs/assets/{guides_github.md.R2QlpR75.js → guides_github.md.DSg0j9qj.js} +29 -3
  33. package/dist/docs/assets/{guides_github.md.R2QlpR75.lean.js → guides_github.md.DSg0j9qj.lean.js} +1 -1
  34. package/dist/docs/assets/guides_opentelemetry.md.DmyUwC5R.js +20 -0
  35. package/dist/docs/assets/guides_opentelemetry.md.DmyUwC5R.lean.js +1 -0
  36. package/dist/docs/assets/{index.md.BKpbkCa6.js → index.md.CMc5FP7E.js} +2 -1
  37. package/dist/docs/assets/{reference_channels.md.BIabFUAI.js → reference_channels.md.MN8iDy8V.js} +1 -1
  38. package/dist/docs/assets/reference_hooks.md.4cbRRIIu.js +14 -0
  39. package/dist/docs/assets/{reference_hooks.md.BHeG-vjK.lean.js → reference_hooks.md.4cbRRIIu.lean.js} +1 -1
  40. package/dist/docs/assets/{reference_project-layout.md._XdeMahr.js → reference_project-layout.md.D3MdHM2z.js} +2 -1
  41. package/dist/docs/assets/templates_triage.md.CConZt1z.js +11 -0
  42. package/dist/docs/assets/templates_triage.md.CConZt1z.lean.js +1 -0
  43. package/dist/docs/building-with-agents.html +5 -5
  44. package/dist/docs/concepts.html +5 -5
  45. package/dist/docs/deployment.html +6 -6
  46. package/dist/docs/evals.html +4 -4
  47. package/dist/docs/example-agents/approval-buddy.html +4 -4
  48. package/dist/docs/example-agents/benny.html +4 -4
  49. package/dist/docs/example-agents/bugbot.html +4 -4
  50. package/dist/docs/example-agents/codebase-wiki.html +4 -4
  51. package/dist/docs/example-agents/codeowners-review.html +4 -4
  52. package/dist/docs/example-agents/concierge.html +4 -4
  53. package/dist/docs/example-agents/fsd.html +4 -4
  54. package/dist/docs/example-agents/index.html +5 -5
  55. package/dist/docs/example-agents/knowledge-base.html +4 -4
  56. package/dist/docs/example-agents/oncall.html +4 -4
  57. package/dist/docs/example-agents/security-reviewer.html +4 -4
  58. package/dist/docs/example-agents/slack-agent.html +4 -4
  59. package/dist/docs/example-agents/weather-agent.html +4 -4
  60. package/dist/docs/guides/agent-to-agent.html +4 -4
  61. package/dist/docs/guides/cloud-runtime.html +5 -5
  62. package/dist/docs/guides/github.html +33 -7
  63. package/dist/docs/guides/human-in-the-loop.html +4 -4
  64. package/dist/docs/guides/mcp-oauth.html +4 -4
  65. package/dist/docs/guides/opentelemetry.html +44 -0
  66. package/dist/docs/guides/slack.html +4 -4
  67. package/dist/docs/guides/webhooks.html +4 -4
  68. package/dist/docs/hashmap.json +1 -1
  69. package/dist/docs/hillclimbing.html +4 -4
  70. package/dist/docs/index.html +7 -6
  71. package/dist/docs/quickstart.html +4 -4
  72. package/dist/docs/reference/agent-config.html +4 -4
  73. package/dist/docs/reference/artifacts.html +4 -4
  74. package/dist/docs/reference/channels.html +6 -6
  75. package/dist/docs/reference/cli.html +4 -4
  76. package/dist/docs/reference/connections.html +4 -4
  77. package/dist/docs/reference/hooks.html +9 -7
  78. package/dist/docs/reference/http-api.html +4 -4
  79. package/dist/docs/reference/instructions.html +4 -4
  80. package/dist/docs/reference/playground.html +4 -4
  81. package/dist/docs/reference/project-layout.html +7 -6
  82. package/dist/docs/reference/prompt.html +4 -4
  83. package/dist/docs/reference/schedules.html +4 -4
  84. package/dist/docs/reference/sessions.html +4 -4
  85. package/dist/docs/reference/skills.html +4 -4
  86. package/dist/docs/reference/subagents.html +4 -4
  87. package/dist/docs/reference/tools.html +4 -4
  88. package/dist/docs/scaffolding-agents.html +4 -4
  89. package/dist/docs/storage.html +4 -4
  90. package/dist/docs/templates/triage.html +35 -0
  91. package/dist/docs/troubleshooting.html +4 -4
  92. package/dist/hooks.d.ts +3 -1
  93. package/dist/hooks.d.ts.map +1 -1
  94. package/dist/hooks.js +3 -1
  95. package/dist/index.d.ts +2 -0
  96. package/dist/index.d.ts.map +1 -1
  97. package/dist/index.js +1 -0
  98. package/dist/internal/cli-ax.d.ts +1 -0
  99. package/dist/internal/cli-ax.d.ts.map +1 -1
  100. package/dist/internal/cli-ax.js +18 -3
  101. package/dist/internal/discovery.d.ts.map +1 -1
  102. package/dist/internal/discovery.js +36 -4
  103. package/dist/internal/distribution.d.ts.map +1 -1
  104. package/dist/internal/distribution.js +1 -0
  105. package/dist/internal/init-project.d.ts +24 -0
  106. package/dist/internal/init-project.d.ts.map +1 -1
  107. package/dist/internal/init-project.js +126 -7
  108. package/dist/internal/otel/attrs.d.ts +7 -0
  109. package/dist/internal/otel/attrs.d.ts.map +1 -0
  110. package/dist/internal/otel/attrs.js +13 -0
  111. package/dist/internal/otel/collector.d.ts +16 -0
  112. package/dist/internal/otel/collector.d.ts.map +1 -0
  113. package/dist/internal/otel/collector.js +564 -0
  114. package/dist/internal/otel/config.d.ts +42 -0
  115. package/dist/internal/otel/config.d.ts.map +1 -0
  116. package/dist/internal/otel/config.js +236 -0
  117. package/dist/internal/otel/http.d.ts +11 -0
  118. package/dist/internal/otel/http.d.ts.map +1 -0
  119. package/dist/internal/otel/http.js +97 -0
  120. package/dist/internal/otel/runtime.d.ts +21 -0
  121. package/dist/internal/otel/runtime.d.ts.map +1 -0
  122. package/dist/internal/otel/runtime.js +188 -0
  123. package/dist/internal/server.d.ts.map +1 -1
  124. package/dist/internal/server.js +25 -1
  125. package/dist/internal/session-engine.d.ts +10 -1
  126. package/dist/internal/session-engine.d.ts.map +1 -1
  127. package/dist/internal/session-engine.js +36 -2
  128. package/dist/memory.d.ts +4 -0
  129. package/dist/memory.d.ts.map +1 -1
  130. package/dist/memory.js +4 -0
  131. package/dist/otel.d.ts +88 -0
  132. package/dist/otel.d.ts.map +1 -0
  133. package/dist/otel.js +64 -0
  134. package/dist/playground/assets/{index-B3HBneZZ.js → index-D-DIYQzw.js} +31 -31
  135. package/dist/playground/assets/index-DQTH622f.css +1 -0
  136. package/dist/playground/index.html +2 -2
  137. package/dist/types.d.ts +31 -4
  138. package/dist/types.d.ts.map +1 -1
  139. package/docs/README.md +3 -0
  140. package/docs/deployment.md +2 -1
  141. package/docs/guides/github.md +79 -6
  142. package/docs/guides/opentelemetry.md +184 -0
  143. package/docs/reference/channels.md +3 -1
  144. package/docs/reference/hooks.md +25 -5
  145. package/docs/reference/project-layout.md +2 -0
  146. package/docs/templates/triage.md +147 -0
  147. package/package.json +23 -1
  148. package/skills/create-agent/SKILL.md +2 -2
  149. package/skills/debug/SKILL.md +4 -0
  150. package/skills/framework-map/SKILL.md +2 -0
  151. package/skills/otel/SKILL.md +80 -0
  152. package/src/bin/agent-serve.ts +3 -1
  153. package/src/channels/github/api.ts +22 -0
  154. package/src/channels/github/defaults.ts +27 -6
  155. package/src/channels/github/github-channel.ts +27 -1
  156. package/src/channels/github/index.ts +1 -0
  157. package/src/channels/github/progress.ts +243 -0
  158. package/src/channels/github/state.ts +3 -0
  159. package/src/channels/github/types.ts +8 -4
  160. package/src/channels/slack/slack-channel.ts +4 -0
  161. package/src/hooks.ts +3 -1
  162. package/src/index.ts +6 -0
  163. package/src/internal/cli-ax.ts +19 -1
  164. package/src/internal/discovery.ts +59 -4
  165. package/src/internal/distribution.ts +1 -0
  166. package/src/internal/init-project.ts +150 -7
  167. package/src/internal/otel/attrs.ts +18 -0
  168. package/src/internal/otel/collector.ts +796 -0
  169. package/src/internal/otel/config.ts +307 -0
  170. package/src/internal/otel/http.ts +126 -0
  171. package/src/internal/otel/runtime.ts +271 -0
  172. package/src/internal/server.ts +38 -1
  173. package/src/internal/session-engine.ts +52 -0
  174. package/src/memory.ts +4 -0
  175. package/src/otel.ts +155 -0
  176. package/src/types.ts +29 -4
  177. package/templates/triage/README.md +48 -0
  178. package/templates/triage/agent/agent.ts +14 -0
  179. package/templates/triage/agent/channels/intake.ts +20 -0
  180. package/templates/triage/agent/channels/slack.ts +3 -0
  181. package/templates/triage/agent/hooks/memory.ts +3 -0
  182. package/templates/triage/agent/instructions.md +27 -0
  183. package/templates/triage/agent/skills/triage-rubric.md +43 -0
  184. package/templates/triage/agent/tools/record_triage.ts +23 -0
  185. package/templates/triage/evals/evals.config.ts +5 -0
  186. package/templates/triage/evals/triage.eval.ts +43 -0
  187. package/templates/triage/package.json +18 -0
  188. package/templates/triage/tsconfig.json +12 -0
  189. package/dist/docs/assets/chunks/@localSearchIndexroot.BA7V8dEJ.js +0 -1
  190. package/dist/docs/assets/reference_hooks.md.BHeG-vjK.js +0 -12
  191. package/dist/playground/assets/index-Bqk9nplh.css +0 -1
  192. /package/dist/docs/assets/{deployment.md.BHVjVqRa.lean.js → deployment.md.Cdp4rTE4.lean.js} +0 -0
  193. /package/dist/docs/assets/{index.md.BKpbkCa6.lean.js → index.md.CMc5FP7E.lean.js} +0 -0
  194. /package/dist/docs/assets/{reference_channels.md.BIabFUAI.lean.js → reference_channels.md.MN8iDy8V.lean.js} +0 -0
  195. /package/dist/docs/assets/{reference_project-layout.md._XdeMahr.lean.js → reference_project-layout.md.D3MdHM2z.lean.js} +0 -0
@@ -0,0 +1,564 @@
1
+ /**
2
+ * Maps the durable session event stream onto OTel traces / metrics / logs.
3
+ *
4
+ * Attribute names reuse Cursor enterprise wire keys where they overlap
5
+ * (`cursor.conversation.id`, `cursor.token.*`, `cursor.tool.*`,
6
+ * `cursor.cost.usage`, `cursor.model.name`) so Agent SDK traces join org
7
+ * metrics/logs in the same collector. Agent-SDK-only fields use `agent_sdk.*`.
8
+ */
9
+ import { context, SpanKind, SpanStatusCode, trace, } from "@opentelemetry/api";
10
+ import { SeverityNumber } from "@opentelemetry/api-logs";
11
+ import { attrs } from "./attrs.js";
12
+ const CONTENT_MAX = 2048;
13
+ export function createOtelCollector(runtime, agentName, log) {
14
+ const sessions = new Map();
15
+ const metrics = runtime.meter ? buildMetrics(runtime.meter) : undefined;
16
+ const logOpts = runtime.config.logs === false ? undefined : runtime.config.logs;
17
+ return {
18
+ onEvent(event, session) {
19
+ try {
20
+ handle(event, session);
21
+ }
22
+ catch (error) {
23
+ log(`[agent-sdk:otel] collector failed on ${event.type}: ${error instanceof Error ? error.message : String(error)}`);
24
+ }
25
+ },
26
+ close() {
27
+ for (const [sessionId, state] of sessions) {
28
+ state.span.setStatus({ code: SpanStatusCode.UNSET });
29
+ state.span.end();
30
+ sessions.delete(sessionId);
31
+ }
32
+ },
33
+ };
34
+ function handle(event, session) {
35
+ var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o;
36
+ var _p, _q;
37
+ const at = Date.parse(event.at);
38
+ const startTime = Number.isFinite(at) ? at : undefined;
39
+ switch (event.type) {
40
+ case "session.started": {
41
+ openSession({
42
+ sessionId: event.sessionId,
43
+ session,
44
+ channelId: event.data.channelId,
45
+ startTime,
46
+ restored: false,
47
+ });
48
+ return;
49
+ }
50
+ case "agent.bound": {
51
+ const state = ensureSession(event, session, startTime);
52
+ if (state === undefined) {
53
+ return;
54
+ }
55
+ state.span.setAttribute("agent_sdk.sdk_agent_id", event.data.sdkAgentId);
56
+ // URL can identify a deployment; keep it off spans unless opted in.
57
+ if ((logOpts === null || logOpts === void 0 ? void 0 : logOpts.toolContent) === true && event.data.url !== undefined) {
58
+ state.span.setAttribute("agent_sdk.sdk_agent_url", event.data.url);
59
+ }
60
+ return;
61
+ }
62
+ case "message.received": {
63
+ const state = ensureSession(event, session, startTime);
64
+ if (state === undefined) {
65
+ return;
66
+ }
67
+ state.span.addEvent("message.received", attrs({
68
+ "agent_sdk.event": "message.received",
69
+ "agent_sdk.user_prompt": (logOpts === null || logOpts === void 0 ? void 0 : logOpts.userPrompts) === true
70
+ ? truncate(event.data.text)
71
+ : undefined,
72
+ }), startTime);
73
+ emitLog("message.received", SeverityNumber.INFO, attrs(Object.assign(Object.assign({}, baseLog(event, session)), { "agent_sdk.user_prompt": (logOpts === null || logOpts === void 0 ? void 0 : logOpts.userPrompts) === true
74
+ ? truncate(event.data.text)
75
+ : undefined })));
76
+ return;
77
+ }
78
+ case "turn.queued": {
79
+ (_a = ensureSession(event, session, startTime)) === null || _a === void 0 ? void 0 : _a.span.addEvent("turn.queued", attrs({
80
+ "agent_sdk.turn_id": event.turnId,
81
+ "agent_sdk.queue_position": event.data.position,
82
+ "agent_sdk.max_running_turns": event.data.maxRunningTurns,
83
+ }), startTime);
84
+ return;
85
+ }
86
+ case "turn.started": {
87
+ if (event.turnId === undefined) {
88
+ return;
89
+ }
90
+ const state = ensureSession(event, session, startTime);
91
+ if (state === undefined) {
92
+ return;
93
+ }
94
+ openTurn({
95
+ state,
96
+ sessionId: event.sessionId,
97
+ turnId: event.turnId,
98
+ session,
99
+ startTime,
100
+ synthetic: false,
101
+ });
102
+ return;
103
+ }
104
+ case "step.started":
105
+ case "step.completed": {
106
+ (_b = ensureTurn(event, session, startTime)) === null || _b === void 0 ? void 0 : _b.span.addEvent(event.type, attrs({
107
+ "agent_sdk.step_id": event.data.stepId,
108
+ "agent_sdk.duration_ms": event.type === "step.completed"
109
+ ? event.data.durationMs
110
+ : undefined,
111
+ }), startTime);
112
+ return;
113
+ }
114
+ case "reasoning.completed": {
115
+ (_c = ensureTurn(event, session, startTime)) === null || _c === void 0 ? void 0 : _c.span.addEvent("reasoning.completed", attrs({
116
+ "agent_sdk.duration_ms": event.data.durationMs,
117
+ "agent_sdk.parent_call_id": event.data.parentCallId,
118
+ }), startTime);
119
+ return;
120
+ }
121
+ case "message.completed": {
122
+ (_d = ensureTurn(event, session, startTime)) === null || _d === void 0 ? void 0 : _d.span.addEvent("message.completed", attrs({
123
+ "agent_sdk.finish_reason": event.data.finishReason,
124
+ "agent_sdk.parent_call_id": event.data.parentCallId,
125
+ }), startTime);
126
+ return;
127
+ }
128
+ case "actions.requested": {
129
+ const turn = ensureTurn(event, session, startTime);
130
+ if (turn === undefined) {
131
+ return;
132
+ }
133
+ for (const call of event.data.calls) {
134
+ const parentCtx = parentCtxFor(turn, (_p = event.data.parentCallId) !== null && _p !== void 0 ? _p : call.parentCallId);
135
+ const span = runtime.tracer.startSpan("agent_sdk.tool", {
136
+ kind: SpanKind.INTERNAL,
137
+ startTime,
138
+ attributes: attrs({
139
+ "cursor.conversation.id": event.sessionId,
140
+ "cursor.tool.name": call.toolName,
141
+ "cursor.tool.kind": "builtin",
142
+ "agent_sdk.agent": agentName,
143
+ "agent_sdk.turn_id": event.turnId,
144
+ "agent_sdk.call_id": call.callId,
145
+ "agent_sdk.parent_call_id": call.parentCallId,
146
+ "agent_sdk.tool_args": (logOpts === null || logOpts === void 0 ? void 0 : logOpts.toolContent) === true && call.args !== undefined
147
+ ? truncate(json(call.args))
148
+ : undefined,
149
+ }),
150
+ }, parentCtx);
151
+ turn.tools.set(call.callId, span);
152
+ }
153
+ return;
154
+ }
155
+ case "action.approval_requested": {
156
+ (_f = (_e = ensureTurn(event, session, startTime)) === null || _e === void 0 ? void 0 : _e.tools.get(event.data.callId)) === null || _f === void 0 ? void 0 : _f.addEvent("approval_requested", undefined, startTime);
157
+ emitLog("action.approval_requested", SeverityNumber.INFO, attrs(Object.assign(Object.assign({}, baseLog(event, session)), { "cursor.tool.name": event.data.toolName, "agent_sdk.call_id": event.data.callId })));
158
+ return;
159
+ }
160
+ case "action.approval_resolved": {
161
+ (_h = (_g = ensureTurn(event, session, startTime)) === null || _g === void 0 ? void 0 : _g.tools.get(event.data.callId)) === null || _h === void 0 ? void 0 : _h.addEvent("approval_resolved", attrs({
162
+ "agent_sdk.decision": event.data.decision,
163
+ "agent_sdk.decision_by": event.data.by,
164
+ }), startTime);
165
+ return;
166
+ }
167
+ case "action.result": {
168
+ const turn = ensureTurn(event, session, startTime);
169
+ const span = turn === null || turn === void 0 ? void 0 : turn.tools.get(event.data.callId);
170
+ const status = event.data.isError ? "failure" : "success";
171
+ if (span !== undefined) {
172
+ span.setAttribute("cursor.tool.status", status);
173
+ if ((logOpts === null || logOpts === void 0 ? void 0 : logOpts.toolContent) === true &&
174
+ event.data.output !== undefined) {
175
+ span.setAttribute("agent_sdk.tool_output", truncate(json(event.data.output)));
176
+ }
177
+ if (event.data.isError) {
178
+ span.setStatus({
179
+ code: SpanStatusCode.ERROR,
180
+ message: "tool error",
181
+ });
182
+ }
183
+ span.end(startTime);
184
+ turn === null || turn === void 0 ? void 0 : turn.tools.delete(event.data.callId);
185
+ }
186
+ metrics === null || metrics === void 0 ? void 0 : metrics.toolCalls.add(1, {
187
+ "cursor.tool.name": event.data.toolName,
188
+ "cursor.tool.kind": "builtin",
189
+ "cursor.tool.status": status,
190
+ "agent_sdk.agent": agentName,
191
+ });
192
+ emitLog("action.result", event.data.isError ? SeverityNumber.ERROR : SeverityNumber.INFO, attrs(Object.assign(Object.assign({}, baseLog(event, session)), { "cursor.tool.name": event.data.toolName, "cursor.tool.status": status, "agent_sdk.call_id": event.data.callId })));
193
+ // Direct callTool never emits turn.completed — close when idle.
194
+ if (turn !== undefined &&
195
+ turn.synthetic &&
196
+ turn.tools.size === 0 &&
197
+ turn.subagents.size === 0 &&
198
+ event.turnId !== undefined) {
199
+ turn.span.setStatus({ code: SpanStatusCode.OK });
200
+ turn.span.end(startTime);
201
+ (_j = sessions.get(event.sessionId)) === null || _j === void 0 ? void 0 : _j.turns.delete(event.turnId);
202
+ }
203
+ return;
204
+ }
205
+ case "subagent.called": {
206
+ const turn = ensureTurn(event, session, startTime);
207
+ if (turn === undefined) {
208
+ return;
209
+ }
210
+ const span = runtime.tracer.startSpan("agent_sdk.subagent", {
211
+ kind: SpanKind.INTERNAL,
212
+ startTime,
213
+ attributes: attrs({
214
+ "cursor.conversation.id": event.sessionId,
215
+ "agent_sdk.agent": agentName,
216
+ "agent_sdk.turn_id": event.turnId,
217
+ "agent_sdk.call_id": event.data.callId,
218
+ "agent_sdk.subagent_name": event.data.name,
219
+ "agent_sdk.subagent_description": (logOpts === null || logOpts === void 0 ? void 0 : logOpts.toolContent) === true &&
220
+ event.data.description !== undefined
221
+ ? truncate(event.data.description)
222
+ : undefined,
223
+ }),
224
+ }, trace.setSpan(context.active(), turn.span));
225
+ turn.subagents.set(event.data.callId, span);
226
+ metrics === null || metrics === void 0 ? void 0 : metrics.subagents.add(1, {
227
+ "agent_sdk.agent": agentName,
228
+ "agent_sdk.subagent_name": (_q = event.data.name) !== null && _q !== void 0 ? _q : "unknown",
229
+ });
230
+ return;
231
+ }
232
+ case "subagent.completed": {
233
+ const turn = ensureTurn(event, session, startTime);
234
+ const span = turn === null || turn === void 0 ? void 0 : turn.subagents.get(event.data.callId);
235
+ if (span !== undefined) {
236
+ span.end(startTime);
237
+ turn === null || turn === void 0 ? void 0 : turn.subagents.delete(event.data.callId);
238
+ }
239
+ return;
240
+ }
241
+ case "artifact.tagged": {
242
+ (_k = ensureSession(event, session, startTime)) === null || _k === void 0 ? void 0 : _k.span.addEvent("artifact.tagged", attrs({
243
+ "agent_sdk.artifact_id": event.data.id,
244
+ "agent_sdk.artifact_kind": event.data.kind,
245
+ "agent_sdk.artifact_key": event.data.key,
246
+ "agent_sdk.artifact_source": event.data.source,
247
+ }), startTime);
248
+ return;
249
+ }
250
+ case "turn.completed": {
251
+ const turn = ensureTurn(event, session, startTime);
252
+ if (turn === undefined || event.turnId === undefined) {
253
+ return;
254
+ }
255
+ endOpenChildren(turn, startTime);
256
+ const usage = event.data.usage;
257
+ const cost = event.data.cost;
258
+ if (usage !== undefined) {
259
+ turn.span.setAttributes(attrs({
260
+ "agent_sdk.usage.input_tokens": usage.inputTokens,
261
+ "agent_sdk.usage.output_tokens": usage.outputTokens,
262
+ "agent_sdk.usage.cache_read_tokens": usage.cacheReadTokens,
263
+ "agent_sdk.usage.cache_write_tokens": usage.cacheWriteTokens,
264
+ "agent_sdk.usage.reasoning_tokens": usage.reasoningTokens,
265
+ }));
266
+ recordTokens(usage);
267
+ }
268
+ if (cost !== undefined) {
269
+ turn.span.setAttributes(attrs({
270
+ "cursor.model.name": cost.model,
271
+ "agent_sdk.cost_usd": cost.totalUsd,
272
+ "agent_sdk.cost_source": cost.source,
273
+ }));
274
+ metrics === null || metrics === void 0 ? void 0 : metrics.cost.add(cost.totalUsd, {
275
+ "cursor.model.name": cost.model,
276
+ "agent_sdk.agent": agentName,
277
+ });
278
+ }
279
+ turn.span.setStatus({ code: SpanStatusCode.OK });
280
+ turn.span.end(startTime);
281
+ (_l = sessions.get(event.sessionId)) === null || _l === void 0 ? void 0 : _l.turns.delete(event.turnId);
282
+ metrics === null || metrics === void 0 ? void 0 : metrics.turns.add(1, {
283
+ "agent_sdk.agent": agentName,
284
+ "agent_sdk.turn_status": "completed",
285
+ });
286
+ emitLog("turn.completed", SeverityNumber.INFO, attrs(Object.assign(Object.assign({}, baseLog(event, session)), { "agent_sdk.usage.input_tokens": usage === null || usage === void 0 ? void 0 : usage.inputTokens, "agent_sdk.usage.output_tokens": usage === null || usage === void 0 ? void 0 : usage.outputTokens, "agent_sdk.cost_usd": cost === null || cost === void 0 ? void 0 : cost.totalUsd, "cursor.model.name": cost === null || cost === void 0 ? void 0 : cost.model })));
287
+ return;
288
+ }
289
+ case "turn.failed": {
290
+ const turn = ensureTurn(event, session, startTime);
291
+ if (turn === undefined || event.turnId === undefined) {
292
+ return;
293
+ }
294
+ endOpenChildren(turn, startTime);
295
+ // Failure text can contain secrets/PII — same gate as log payloads.
296
+ const failureText = gatedContent(event.data.message);
297
+ turn.span.setStatus({
298
+ code: SpanStatusCode.ERROR,
299
+ message: failureText !== null && failureText !== void 0 ? failureText : "turn failed",
300
+ });
301
+ if (failureText !== undefined) {
302
+ turn.span.recordException(new Error(failureText));
303
+ }
304
+ turn.span.end(startTime);
305
+ (_m = sessions.get(event.sessionId)) === null || _m === void 0 ? void 0 : _m.turns.delete(event.turnId);
306
+ metrics === null || metrics === void 0 ? void 0 : metrics.turns.add(1, {
307
+ "agent_sdk.agent": agentName,
308
+ "agent_sdk.turn_status": "failed",
309
+ });
310
+ emitLog("turn.failed", SeverityNumber.ERROR, attrs(Object.assign(Object.assign({}, baseLog(event, session)), { "agent_sdk.error_message": failureText })));
311
+ return;
312
+ }
313
+ case "session.waiting": {
314
+ (_o = ensureSession(event, session, startTime)) === null || _o === void 0 ? void 0 : _o.span.addEvent("session.waiting", undefined, startTime);
315
+ return;
316
+ }
317
+ case "session.completed": {
318
+ endSession({
319
+ sessionId: event.sessionId,
320
+ code: SpanStatusCode.OK,
321
+ message: undefined,
322
+ endTime: startTime,
323
+ });
324
+ return;
325
+ }
326
+ case "session.failed": {
327
+ const failureText = gatedContent(event.data.message);
328
+ endSession({
329
+ sessionId: event.sessionId,
330
+ code: SpanStatusCode.ERROR,
331
+ message: failureText !== null && failureText !== void 0 ? failureText : "session failed",
332
+ endTime: startTime,
333
+ });
334
+ emitLog("session.failed", SeverityNumber.ERROR, attrs(Object.assign(Object.assign({}, baseLog(event, session)), { "agent_sdk.error_message": failureText })));
335
+ return;
336
+ }
337
+ default:
338
+ return;
339
+ }
340
+ }
341
+ /**
342
+ * Open a session span on first live event after restore/resume (no
343
+ * `session.started` in this process). Fresh sessions still use the
344
+ * dedicated `session.started` case.
345
+ */
346
+ function ensureSession(event, session, startTime) {
347
+ const existing = sessions.get(event.sessionId);
348
+ if (existing !== undefined) {
349
+ return existing;
350
+ }
351
+ return openSession({
352
+ sessionId: event.sessionId,
353
+ session,
354
+ channelId: session.channelId,
355
+ startTime,
356
+ restored: true,
357
+ });
358
+ }
359
+ function openSession(args) {
360
+ var _a;
361
+ const parent = context.active();
362
+ const span = runtime.tracer.startSpan("agent_sdk.session", {
363
+ kind: SpanKind.INTERNAL,
364
+ startTime: args.startTime,
365
+ attributes: attrs({
366
+ "cursor.conversation.id": args.sessionId,
367
+ "agent_sdk.agent": agentName,
368
+ "agent_sdk.channel": args.channelId,
369
+ "agent_sdk.session_mode": args.session.mode,
370
+ "agent_sdk.session_purpose": (_a = args.session.purpose) !== null && _a !== void 0 ? _a : "live",
371
+ "agent_sdk.session_restored": args.restored ? true : undefined,
372
+ }),
373
+ }, parent);
374
+ const state = {
375
+ span,
376
+ ctx: trace.setSpan(parent, span),
377
+ turns: new Map(),
378
+ };
379
+ sessions.set(args.sessionId, state);
380
+ if (!args.restored) {
381
+ metrics === null || metrics === void 0 ? void 0 : metrics.sessions.add(1, {
382
+ "agent_sdk.agent": agentName,
383
+ "agent_sdk.channel": args.channelId,
384
+ });
385
+ }
386
+ return state;
387
+ }
388
+ /**
389
+ * Direct `callTool` and post-restore turns may emit tool events without
390
+ * a prior `turn.started` in this process — open a synthetic turn span.
391
+ */
392
+ function ensureTurn(event, session, startTime) {
393
+ if (event.turnId === undefined) {
394
+ return undefined;
395
+ }
396
+ const state = ensureSession(event, session, startTime);
397
+ if (state === undefined) {
398
+ return undefined;
399
+ }
400
+ const existing = state.turns.get(event.turnId);
401
+ if (existing !== undefined) {
402
+ return existing;
403
+ }
404
+ return openTurn({
405
+ state,
406
+ sessionId: event.sessionId,
407
+ turnId: event.turnId,
408
+ session,
409
+ startTime,
410
+ synthetic: true,
411
+ });
412
+ }
413
+ function openTurn(args) {
414
+ const span = runtime.tracer.startSpan("agent_sdk.turn", {
415
+ kind: SpanKind.INTERNAL,
416
+ startTime: args.startTime,
417
+ attributes: attrs({
418
+ "cursor.conversation.id": args.sessionId,
419
+ "agent_sdk.agent": agentName,
420
+ "agent_sdk.turn_id": args.turnId,
421
+ "agent_sdk.channel": args.session.channelId,
422
+ "agent_sdk.turn_synthetic": args.synthetic ? true : undefined,
423
+ }),
424
+ }, args.state.ctx);
425
+ const turn = {
426
+ span,
427
+ tools: new Map(),
428
+ subagents: new Map(),
429
+ synthetic: args.synthetic,
430
+ };
431
+ args.state.turns.set(args.turnId, turn);
432
+ return turn;
433
+ }
434
+ function parentCtxFor(turn, parentCallId) {
435
+ if (parentCallId !== undefined) {
436
+ const sub = turn.subagents.get(parentCallId);
437
+ if (sub !== undefined) {
438
+ return trace.setSpan(context.active(), sub);
439
+ }
440
+ }
441
+ return trace.setSpan(context.active(), turn.span);
442
+ }
443
+ function endOpenChildren(turn, endTime) {
444
+ for (const span of turn.tools.values()) {
445
+ span.end(endTime);
446
+ }
447
+ turn.tools.clear();
448
+ for (const span of turn.subagents.values()) {
449
+ span.end(endTime);
450
+ }
451
+ turn.subagents.clear();
452
+ }
453
+ function endSession(args) {
454
+ const state = sessions.get(args.sessionId);
455
+ if (state === undefined) {
456
+ return;
457
+ }
458
+ for (const turn of state.turns.values()) {
459
+ endOpenChildren(turn, args.endTime);
460
+ turn.span.end(args.endTime);
461
+ }
462
+ state.turns.clear();
463
+ state.span.setStatus(args.message === undefined
464
+ ? { code: args.code }
465
+ : { code: args.code, message: args.message });
466
+ state.span.end(args.endTime);
467
+ sessions.delete(args.sessionId);
468
+ }
469
+ function recordTokens(usage) {
470
+ if (metrics === undefined) {
471
+ return;
472
+ }
473
+ const agent = agentName;
474
+ // Wire token types match enterprise export (`cache_creation`, not write).
475
+ addTokens(usage.inputTokens, "input", agent);
476
+ addTokens(usage.outputTokens, "output", agent);
477
+ addTokens(usage.cacheReadTokens, "cache_read", agent);
478
+ addTokens(usage.cacheWriteTokens, "cache_creation", agent);
479
+ if (usage.reasoningTokens !== undefined) {
480
+ // Reasoning is Agent-SDK-only; enterprise wire has no reasoning enum.
481
+ metrics.tokens.add(usage.reasoningTokens, {
482
+ "cursor.token.type": "reasoning",
483
+ "agent_sdk.agent": agent,
484
+ });
485
+ }
486
+ }
487
+ function addTokens(value, type, agent) {
488
+ if (metrics === undefined || value === 0) {
489
+ return;
490
+ }
491
+ metrics.tokens.add(value, {
492
+ "cursor.token.type": type,
493
+ "agent_sdk.agent": agent,
494
+ });
495
+ }
496
+ /** Content opt-in for failure text (same gate as tool payloads). */
497
+ function gatedContent(value) {
498
+ if ((logOpts === null || logOpts === void 0 ? void 0 : logOpts.toolContent) !== true) {
499
+ return undefined;
500
+ }
501
+ return truncate(value);
502
+ }
503
+ function baseLog(event, session) {
504
+ return {
505
+ "cursor.conversation.id": event.sessionId,
506
+ "agent_sdk.event": event.type,
507
+ "agent_sdk.agent": agentName,
508
+ "agent_sdk.channel": session.channelId,
509
+ "agent_sdk.turn_id": event.turnId,
510
+ };
511
+ }
512
+ function emitLog(eventName, severity, attributes) {
513
+ var _a;
514
+ (_a = runtime.logger) === null || _a === void 0 ? void 0 : _a.emit({
515
+ body: eventName,
516
+ severityNumber: severity,
517
+ attributes,
518
+ });
519
+ }
520
+ }
521
+ function buildMetrics(meter) {
522
+ return {
523
+ sessions: meter.createCounter("agent_sdk.session.count", {
524
+ description: "Sessions started",
525
+ unit: "{session}",
526
+ }),
527
+ turns: meter.createCounter("agent_sdk.turn.count", {
528
+ description: "Turns completed or failed",
529
+ unit: "{turn}",
530
+ }),
531
+ // Wire-aligned name so collectors joining org export see one series family.
532
+ toolCalls: meter.createCounter("cursor.tool.calls", {
533
+ description: "Tool calls finished",
534
+ unit: "{call}",
535
+ }),
536
+ subagents: meter.createCounter("agent_sdk.subagent.count", {
537
+ description: "Subagent invocations",
538
+ unit: "{call}",
539
+ }),
540
+ tokens: meter.createCounter("cursor.token.usage", {
541
+ description: "Token usage by type",
542
+ unit: "{token}",
543
+ }),
544
+ cost: meter.createCounter("cursor.cost.usage", {
545
+ description: "Estimated turn cost in USD",
546
+ unit: "USD",
547
+ }),
548
+ };
549
+ }
550
+ function truncate(value) {
551
+ if (value.length <= CONTENT_MAX) {
552
+ return value;
553
+ }
554
+ return `${value.slice(0, CONTENT_MAX)}…`;
555
+ }
556
+ function json(value) {
557
+ var _a;
558
+ try {
559
+ return (_a = JSON.stringify(value)) !== null && _a !== void 0 ? _a : String(value);
560
+ }
561
+ catch (_b) {
562
+ return String(value);
563
+ }
564
+ }
@@ -0,0 +1,42 @@
1
+ /**
2
+ * Merge authored `defineOtel`, `serve({ otel })`, and standard OTel env.
3
+ */
4
+ import type { OtelConfig, OtelDefinition, OtelExporterConfig, OtelLogOptions, OtelMetricOptions, OtelSignal, OtelTraceOptions } from "../../otel.js";
5
+ export interface ResolvedOtelConfig {
6
+ enabled: boolean;
7
+ serviceName: string;
8
+ serviceVersion: string | undefined;
9
+ resourceAttributes: Record<string, string>;
10
+ exporters: OtelExporterConfig[];
11
+ traces: false | OtelTraceOptions;
12
+ metrics: false | OtelMetricOptions;
13
+ logs: false | OtelLogOptions;
14
+ }
15
+ /** True when any standard OTLP endpoint env var is set. */
16
+ export declare function hasOtelEnv(env?: NodeJS.ProcessEnv): boolean;
17
+ /**
18
+ * Process-global authored config. OTel SDK is one per serve process — if
19
+ * several mounts ship `agent/otel.ts`, they must be identical.
20
+ */
21
+ export declare function pickAuthoredOtel(mounts: ReadonlyArray<{
22
+ slug: string;
23
+ name: string;
24
+ otel?: OtelDefinition;
25
+ }>): OtelDefinition | undefined;
26
+ /**
27
+ * Resolve effective config.
28
+ *
29
+ * Precedence: `serve({ otel: false })` disables; otherwise merge
30
+ * `serve({ otel })` over `defineOtel` over env defaults.
31
+ */
32
+ export declare function resolveOtelConfig(input: {
33
+ authored?: OtelConfig;
34
+ serve?: OtelConfig | false;
35
+ env?: NodeJS.ProcessEnv;
36
+ }): ResolvedOtelConfig;
37
+ export declare function parseOtelHeaders(raw: string | undefined): Record<string, string>;
38
+ /** Collapse `…/v1/{traces,metrics,logs}` to the collector base. */
39
+ export declare function stripSignalPath(url: string): string;
40
+ /** Exporters that apply to one signal (honors per-exporter `signals`). */
41
+ export declare function exportersForSignal(exporters: readonly OtelExporterConfig[], signal: OtelSignal): OtelExporterConfig[];
42
+ //# sourceMappingURL=config.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/internal/otel/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EACjB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,MAAM,EAAE,KAAK,GAAG,gBAAgB,CAAC;IACjC,OAAO,EAAE,KAAK,GAAG,iBAAiB,CAAC;IACnC,IAAI,EAAE,KAAK,GAAG,cAAc,CAAC;CAC9B;AAED,2DAA2D;AAC3D,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAOxE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,cAAc,CAAA;CAAE,CAAC,GAC3E,cAAc,GAAG,SAAS,CAmB5B;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,KAAK,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,GAAG,kBAAkB,CAiDrB;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiBxB;AAED,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,kBAAkB,EAAE,EACxC,MAAM,EAAE,UAAU,GACjB,kBAAkB,EAAE,CAKtB"}