@senpi-ai/runtime 1.1.0 → 1.1.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 (155) hide show
  1. package/dist/actions/close-position/close-position.action.d.ts.map +1 -1
  2. package/dist/actions/close-position/close-position.action.js +4 -1
  3. package/dist/actions/close-position/close-position.action.js.map +1 -1
  4. package/dist/actions/llm-decision/anthropic-llm-decision.d.ts +9 -0
  5. package/dist/actions/llm-decision/anthropic-llm-decision.d.ts.map +1 -1
  6. package/dist/actions/llm-decision/anthropic-llm-decision.js +90 -3
  7. package/dist/actions/llm-decision/anthropic-llm-decision.js.map +1 -1
  8. package/dist/actions/llm-decision/factory.d.ts +6 -0
  9. package/dist/actions/llm-decision/factory.d.ts.map +1 -1
  10. package/dist/actions/llm-decision/factory.js +2 -0
  11. package/dist/actions/llm-decision/factory.js.map +1 -1
  12. package/dist/actions/llm-decision/openclaw-llm-decision.d.ts +30 -0
  13. package/dist/actions/llm-decision/openclaw-llm-decision.d.ts.map +1 -1
  14. package/dist/actions/llm-decision/openclaw-llm-decision.js +114 -15
  15. package/dist/actions/llm-decision/openclaw-llm-decision.js.map +1 -1
  16. package/dist/actions/open-position/open-position.action.d.ts.map +1 -1
  17. package/dist/actions/open-position/open-position.action.js +4 -1
  18. package/dist/actions/open-position/open-position.action.js.map +1 -1
  19. package/dist/cli/guide-commands.d.ts.map +1 -1
  20. package/dist/cli/guide-commands.js +8 -4
  21. package/dist/cli/guide-commands.js.map +1 -1
  22. package/dist/cli/senpi-cli-config.d.ts +15 -1
  23. package/dist/cli/senpi-cli-config.d.ts.map +1 -1
  24. package/dist/cli/senpi-cli-config.js +20 -4
  25. package/dist/cli/senpi-cli-config.js.map +1 -1
  26. package/dist/cli/senpi-commands.d.ts.map +1 -1
  27. package/dist/cli/senpi-commands.js +163 -0
  28. package/dist/cli/senpi-commands.js.map +1 -1
  29. package/dist/dsl/engine-client/config-mapping.d.ts +5 -0
  30. package/dist/dsl/engine-client/config-mapping.d.ts.map +1 -1
  31. package/dist/dsl/engine-client/config-mapping.js +14 -2
  32. package/dist/dsl/engine-client/config-mapping.js.map +1 -1
  33. package/dist/dsl/monitor/process-one-position.d.ts.map +1 -1
  34. package/dist/dsl/monitor/process-one-position.js +24 -1
  35. package/dist/dsl/monitor/process-one-position.js.map +1 -1
  36. package/dist/index.d.ts +21 -0
  37. package/dist/index.d.ts.map +1 -1
  38. package/dist/index.js +116 -1
  39. package/dist/index.js.map +1 -1
  40. package/dist/runtime/auto-update/coordinator.d.ts +13 -0
  41. package/dist/runtime/auto-update/coordinator.d.ts.map +1 -1
  42. package/dist/runtime/auto-update/coordinator.js +22 -8
  43. package/dist/runtime/auto-update/coordinator.js.map +1 -1
  44. package/dist/runtime/decision-errors.d.ts +166 -0
  45. package/dist/runtime/decision-errors.d.ts.map +1 -0
  46. package/dist/runtime/decision-errors.js +328 -0
  47. package/dist/runtime/decision-errors.js.map +1 -0
  48. package/dist/runtime/notifications.d.ts +15 -1
  49. package/dist/runtime/notifications.d.ts.map +1 -1
  50. package/dist/runtime/notifications.js +16 -57
  51. package/dist/runtime/notifications.js.map +1 -1
  52. package/dist/runtime/run.d.ts +6 -0
  53. package/dist/runtime/run.d.ts.map +1 -1
  54. package/dist/runtime/run.js +1 -0
  55. package/dist/runtime/run.js.map +1 -1
  56. package/dist/runtime/runtime-schema.d.ts +1091 -73
  57. package/dist/runtime/runtime-schema.d.ts.map +1 -1
  58. package/dist/runtime/runtime-schema.js +34 -0
  59. package/dist/runtime/runtime-schema.js.map +1 -1
  60. package/dist/runtime/runtime.d.ts +8 -0
  61. package/dist/runtime/runtime.d.ts.map +1 -1
  62. package/dist/runtime/runtime.js +57 -37
  63. package/dist/runtime/runtime.js.map +1 -1
  64. package/dist/senpi/client.d.ts +1 -0
  65. package/dist/senpi/client.d.ts.map +1 -1
  66. package/dist/senpi/client.js +51 -0
  67. package/dist/senpi/client.js.map +1 -1
  68. package/dist/senpi/types.d.ts +2 -1
  69. package/dist/senpi/types.d.ts.map +1 -1
  70. package/dist/skills-manager/bootstrap.d.ts +26 -0
  71. package/dist/skills-manager/bootstrap.d.ts.map +1 -0
  72. package/dist/skills-manager/bootstrap.js +86 -0
  73. package/dist/skills-manager/bootstrap.js.map +1 -0
  74. package/dist/skills-manager/constants.d.ts +65 -0
  75. package/dist/skills-manager/constants.d.ts.map +1 -0
  76. package/dist/skills-manager/constants.js +91 -0
  77. package/dist/skills-manager/constants.js.map +1 -0
  78. package/dist/skills-manager/coordinator.d.ts +346 -0
  79. package/dist/skills-manager/coordinator.d.ts.map +1 -0
  80. package/dist/skills-manager/coordinator.js +1037 -0
  81. package/dist/skills-manager/coordinator.js.map +1 -0
  82. package/dist/skills-manager/fetcher.d.ts +28 -0
  83. package/dist/skills-manager/fetcher.d.ts.map +1 -0
  84. package/dist/skills-manager/fetcher.js +92 -0
  85. package/dist/skills-manager/fetcher.js.map +1 -0
  86. package/dist/skills-manager/index.d.ts +5 -0
  87. package/dist/skills-manager/index.d.ts.map +1 -0
  88. package/dist/skills-manager/index.js +4 -0
  89. package/dist/skills-manager/index.js.map +1 -0
  90. package/dist/skills-manager/state-store.d.ts +57 -0
  91. package/dist/skills-manager/state-store.d.ts.map +1 -0
  92. package/dist/skills-manager/state-store.js +129 -0
  93. package/dist/skills-manager/state-store.js.map +1 -0
  94. package/dist/skills-manager/types.d.ts +177 -0
  95. package/dist/skills-manager/types.d.ts.map +1 -0
  96. package/dist/skills-manager/types.js +2 -0
  97. package/dist/skills-manager/types.js.map +1 -0
  98. package/dist/skills-manager/utils.d.ts +81 -0
  99. package/dist/skills-manager/utils.d.ts.map +1 -0
  100. package/dist/skills-manager/utils.js +143 -0
  101. package/dist/skills-manager/utils.js.map +1 -0
  102. package/dist/skills-manager/version-manager.d.ts +146 -0
  103. package/dist/skills-manager/version-manager.d.ts.map +1 -0
  104. package/dist/skills-manager/version-manager.js +299 -0
  105. package/dist/skills-manager/version-manager.js.map +1 -0
  106. package/dist/skills-manager/writer.d.ts +28 -0
  107. package/dist/skills-manager/writer.d.ts.map +1 -0
  108. package/dist/skills-manager/writer.js +101 -0
  109. package/dist/skills-manager/writer.js.map +1 -0
  110. package/dist/tracking/context.d.ts +31 -0
  111. package/dist/tracking/context.d.ts.map +1 -0
  112. package/dist/tracking/context.js +20 -0
  113. package/dist/tracking/context.js.map +1 -0
  114. package/dist/tracking/spans/constants.d.ts +19 -0
  115. package/dist/tracking/spans/constants.d.ts.map +1 -0
  116. package/dist/tracking/spans/constants.js +31 -0
  117. package/dist/tracking/spans/constants.js.map +1 -0
  118. package/dist/tracking/spans/index.d.ts +13 -0
  119. package/dist/tracking/spans/index.d.ts.map +1 -0
  120. package/dist/tracking/spans/index.js +16 -0
  121. package/dist/tracking/spans/index.js.map +1 -0
  122. package/dist/tracking/spans/plugin-span-tracker.d.ts +3 -0
  123. package/dist/tracking/spans/plugin-span-tracker.d.ts.map +1 -0
  124. package/dist/tracking/spans/plugin-span-tracker.js +42 -0
  125. package/dist/tracking/spans/plugin-span-tracker.js.map +1 -0
  126. package/dist/tracking/spans/redact-pii.d.ts +115 -0
  127. package/dist/tracking/spans/redact-pii.d.ts.map +1 -0
  128. package/dist/tracking/spans/redact-pii.js +464 -0
  129. package/dist/tracking/spans/redact-pii.js.map +1 -0
  130. package/dist/tracking/spans/sanitize-payload.d.ts +19 -0
  131. package/dist/tracking/spans/sanitize-payload.d.ts.map +1 -0
  132. package/dist/tracking/spans/sanitize-payload.js +68 -0
  133. package/dist/tracking/spans/sanitize-payload.js.map +1 -0
  134. package/dist/tracking/spans/span-hooks.d.ts +28 -0
  135. package/dist/tracking/spans/span-hooks.d.ts.map +1 -0
  136. package/dist/tracking/spans/span-hooks.js +409 -0
  137. package/dist/tracking/spans/span-hooks.js.map +1 -0
  138. package/dist/tracking/spans/span-tracker.d.ts +133 -0
  139. package/dist/tracking/spans/span-tracker.d.ts.map +1 -0
  140. package/dist/tracking/spans/span-tracker.js +721 -0
  141. package/dist/tracking/spans/span-tracker.js.map +1 -0
  142. package/dist/tracking/spans/span-transport.d.ts +65 -0
  143. package/dist/tracking/spans/span-transport.d.ts.map +1 -0
  144. package/dist/tracking/spans/span-transport.js +240 -0
  145. package/dist/tracking/spans/span-transport.js.map +1 -0
  146. package/dist/tracking/spans/types.d.ts +101 -0
  147. package/dist/tracking/spans/types.d.ts.map +1 -0
  148. package/dist/tracking/spans/types.js +6 -0
  149. package/dist/tracking/spans/types.js.map +1 -0
  150. package/dist/utils/retry.d.ts +7 -0
  151. package/dist/utils/retry.d.ts.map +1 -1
  152. package/dist/utils/retry.js +5 -1
  153. package/dist/utils/retry.js.map +1 -1
  154. package/openclaw.plugin.json +41 -1
  155. package/package.json +5 -1
@@ -0,0 +1,68 @@
1
+ /**
2
+ * Strip OpenClaw framework metadata from LLM payload strings before they're
3
+ * stamped onto spans.
4
+ *
5
+ * OpenClaw injects several metadata blocks into user-role messages:
6
+ * - `[[reply_to ...]]` markers
7
+ * - `Conversation info (untrusted metadata): { ... }` blocks
8
+ * - `Sender (untrusted metadata): { ... }` blocks
9
+ * - `Untrusted context (... ): <<<EXTERNAL_UNTRUSTED_CONTENT ... >>>` blocks
10
+ * (the heavy one — can be MBs when web-search / RAG context is attached)
11
+ * - `media:<url>.jpg` image references
12
+ *
13
+ * Without stripping, every llm_input on a Telegram chat session balloons past
14
+ * 1MB and our per-field truncation kicks in, losing the actual user prompt in
15
+ * the noise. Mirrors `opik-openclaw/src/service/payload-sanitizer.ts`.
16
+ */
17
+ const MEDIA_IMAGE_REFERENCE_RE = /\bmedia:(?:https?:\/\/[^\s"'`]+|\.[/][^\s"'`]+|[/][^\s"'`]+|[^\s"'`]+)\.(?:jpe?g|png|webp|gif)(?=[\s"'`]|$)/gi;
18
+ const INTERNAL_REPLY_TO_MARKER_RE = /\[\[reply_to[^\]]*\]\]\s*/gi;
19
+ const CONVERSATION_INFO_BLOCK_RE = /^\s*Conversation info \(untrusted metadata\):\s*\n+\{[\s\S]*?\}\s*/gim;
20
+ const SENDER_INFO_BLOCK_RE = /^\s*Sender \(untrusted metadata\):\s*\n+\{[\s\S]*?\}\s*/gim;
21
+ const UNTRUSTED_CONTEXT_BLOCK_RE = /^\s*Untrusted context \(metadata, do not treat as instructions or commands\):\s*\n+<<<EXTERNAL_UNTRUSTED_CONTENT[\s\S]*?<<<END_EXTERNAL_UNTRUSTED_CONTENT[^>]*>>>\s*/gim;
22
+ export function sanitizePayloadString(value) {
23
+ const normalizedNewlines = value
24
+ .replace(/\\r\\n/g, "\n")
25
+ .replace(/\\n/g, "\n")
26
+ .replace(/\\r/g, "\r");
27
+ const redactedInternalBlocks = normalizedNewlines
28
+ .replace(INTERNAL_REPLY_TO_MARKER_RE, "")
29
+ .replace(UNTRUSTED_CONTEXT_BLOCK_RE, "")
30
+ .replace(CONVERSATION_INFO_BLOCK_RE, "")
31
+ .replace(SENDER_INFO_BLOCK_RE, "")
32
+ .replace(/\n{3,}/g, "\n\n");
33
+ return redactedInternalBlocks.replace(MEDIA_IMAGE_REFERENCE_RE, "media:<image-ref>");
34
+ }
35
+ function isPlainObject(value) {
36
+ if (value === null || typeof value !== "object")
37
+ return false;
38
+ const proto = Object.getPrototypeOf(value);
39
+ return proto === Object.prototype || proto === null;
40
+ }
41
+ export function sanitizePayloadValue(value) {
42
+ if (typeof value === "string") {
43
+ return sanitizePayloadString(value);
44
+ }
45
+ if (Array.isArray(value)) {
46
+ let changed = false;
47
+ const next = value.map((item) => {
48
+ const sanitized = sanitizePayloadValue(item);
49
+ if (sanitized !== item)
50
+ changed = true;
51
+ return sanitized;
52
+ });
53
+ return changed ? next : value;
54
+ }
55
+ if (isPlainObject(value)) {
56
+ let changed = false;
57
+ const next = {};
58
+ for (const [key, child] of Object.entries(value)) {
59
+ const sanitized = sanitizePayloadValue(child);
60
+ next[key] = sanitized;
61
+ if (sanitized !== child)
62
+ changed = true;
63
+ }
64
+ return changed ? next : value;
65
+ }
66
+ return value;
67
+ }
68
+ //# sourceMappingURL=sanitize-payload.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sanitize-payload.js","sourceRoot":"","sources":["../../../src/tracking/spans/sanitize-payload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,wBAAwB,GAC5B,+GAA+G,CAAC;AAClH,MAAM,2BAA2B,GAAG,6BAA6B,CAAC;AAClE,MAAM,0BAA0B,GAC9B,uEAAuE,CAAC;AAC1E,MAAM,oBAAoB,GAAG,4DAA4D,CAAC;AAC1F,MAAM,0BAA0B,GAC9B,yKAAyK,CAAC;AAE5K,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,MAAM,kBAAkB,GAAG,KAAK;SAC7B,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC;SACxB,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;SACrB,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACzB,MAAM,sBAAsB,GAAG,kBAAkB;SAC9C,OAAO,CAAC,2BAA2B,EAAE,EAAE,CAAC;SACxC,OAAO,CAAC,0BAA0B,EAAE,EAAE,CAAC;SACvC,OAAO,CAAC,0BAA0B,EAAE,EAAE,CAAC;SACvC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC;SACjC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC9B,OAAO,sBAAsB,CAAC,OAAO,CAAC,wBAAwB,EAAE,mBAAmB,CAAC,CAAC;AACvF,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC3C,OAAO,KAAK,KAAK,MAAM,CAAC,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YAC9B,MAAM,SAAS,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;YAC7C,IAAI,SAAS,KAAK,IAAI;gBAAE,OAAO,GAAG,IAAI,CAAC;YACvC,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC,CAAC;QACH,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IAChC,CAAC;IACD,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,IAAI,GAA4B,EAAE,CAAC;QACzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,MAAM,SAAS,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;YAC9C,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;YACtB,IAAI,SAAS,KAAK,KAAK;gBAAE,OAAO,GAAG,IAAI,CAAC;QAC1C,CAAC;QACD,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IAChC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
@@ -0,0 +1,28 @@
1
+ /**
2
+ * registerSpanHooks: wires OpenClaw plugin hooks to SpanTracker.
3
+ *
4
+ * Subscribes to nine hooks total: llm_input, llm_output, before_tool_call,
5
+ * after_tool_call, subagent_spawning, subagent_spawned, subagent_delivery_target,
6
+ * subagent_ended, agent_end.
7
+ *
8
+ * Senpi-context fields (correlation_id, address, recipe_name, runtime_id,
9
+ * runtime_version) are read from request headers passed in agentCtx — see
10
+ * openclaw-llm-decision.ts for the matching header propagation.
11
+ *
12
+ * Handlers never throw — errors are caught and logged.
13
+ */
14
+ import type { SpanTracker } from "./span-tracker.js";
15
+ /** Minimal shape of the OpenClaw plugin API surface we need. */
16
+ export interface SpanHooksPluginApi {
17
+ on(hookName: string, handler: (...args: unknown[]) => void | Promise<void>, opts?: {
18
+ priority?: number;
19
+ }): void;
20
+ }
21
+ export interface RegisterSpanHooksOptions {
22
+ api: SpanHooksPluginApi;
23
+ tracker: SpanTracker;
24
+ /** Override Date.now for tests. */
25
+ now?: () => number;
26
+ }
27
+ export declare function registerSpanHooks(options: RegisterSpanHooksOptions): void;
28
+ //# sourceMappingURL=span-hooks.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"span-hooks.d.ts","sourceRoot":"","sources":["../../../src/tracking/spans/span-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,WAAW,EAAqB,MAAM,mBAAmB,CAAC;AAaxE,gEAAgE;AAChE,MAAM,WAAW,kBAAkB;IACjC,EAAE,CACA,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EACrD,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3B,IAAI,CAAC;CACT;AAED,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,kBAAkB,CAAC;IACxB,OAAO,EAAE,WAAW,CAAC;IACrB,mCAAmC;IACnC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI,CA4TzE"}
@@ -0,0 +1,409 @@
1
+ import { HEADER_ADDRESS, HEADER_CORRELATION_ID, HEADER_RECIPE_NAME, HEADER_RUNTIME_ID, HEADER_RUNTIME_VERSION, } from "./constants.js";
2
+ import { createLogger } from "../../utils/logger.js";
3
+ import { sanitizePayloadValue } from "./sanitize-payload.js";
4
+ const logger = createLogger("[senpi-core][span-hooks]");
5
+ export function registerSpanHooks(options) {
6
+ const { api, tracker } = options;
7
+ // Tool hooks often arrive with a ctx that lacks sessionKey/runId — OpenClaw
8
+ // doesn't always thread the host agent's identity through to tool calls.
9
+ // Mirror opik's fallback strategy: remember (agentId → sessionKey/runId)
10
+ // from llm_input, and the last seen pair, so tool hooks can resolve them.
11
+ const sessionByAgentId = new Map();
12
+ let lastActive = null;
13
+ const rememberSession = (agentCtx, sessionKey, runId) => {
14
+ const agentId = nonEmptyString(asRecord(agentCtx)?.agentId);
15
+ if (agentId)
16
+ sessionByAgentId.set(agentId, { sessionKey, runId });
17
+ lastActive = { sessionKey, runId };
18
+ };
19
+ const resolveToolSession = (ctx) => {
20
+ const direct = {
21
+ sessionKey: readSessionKey(ctx, undefined),
22
+ runId: readRunId(ctx, undefined),
23
+ };
24
+ if (direct.sessionKey && direct.runId) {
25
+ return { sessionKey: direct.sessionKey, runId: direct.runId };
26
+ }
27
+ const agentId = nonEmptyString(asRecord(ctx)?.agentId);
28
+ if (agentId) {
29
+ const hit = sessionByAgentId.get(agentId);
30
+ if (hit)
31
+ return hit;
32
+ }
33
+ return lastActive;
34
+ };
35
+ // ─── LLM ───────────────────────────────────────────────────────────────
36
+ api.on("llm_input", (event, agentCtx) => {
37
+ try {
38
+ const ctx = readContext(agentCtx);
39
+ const sessionKey = readSessionKey(agentCtx, event);
40
+ const runId = readRunId(agentCtx, event);
41
+ if (!sessionKey || !runId) {
42
+ logger.warn("llm_input missing sessionKey/runId; skipping span");
43
+ return;
44
+ }
45
+ rememberSession(agentCtx, sessionKey, runId);
46
+ tracker.openLlmSpan({
47
+ sessionKey,
48
+ runId,
49
+ emissionSource: "hook",
50
+ input: extractLlmInput(event),
51
+ ...ctx,
52
+ });
53
+ }
54
+ catch (err) {
55
+ logger.warn("llm_input handler failed", { err: errMsg(err) });
56
+ }
57
+ });
58
+ api.on("llm_output", (event, agentCtx) => {
59
+ try {
60
+ const ctx = readContext(agentCtx);
61
+ const sessionKey = readSessionKey(agentCtx, event);
62
+ const runId = readRunId(agentCtx, event);
63
+ if (!sessionKey || !runId) {
64
+ logger.warn("llm_output missing sessionKey/runId; skipping span");
65
+ return;
66
+ }
67
+ rememberSession(agentCtx, sessionKey, runId);
68
+ const out = extractLlmOutput(event);
69
+ tracker.finalizeLlmSpan({
70
+ sessionKey,
71
+ runId,
72
+ output: out.output,
73
+ model: out.model,
74
+ tokensIn: out.tokensIn,
75
+ tokensOut: out.tokensOut,
76
+ ...ctx,
77
+ });
78
+ }
79
+ catch (err) {
80
+ logger.warn("llm_output handler failed", { err: errMsg(err) });
81
+ }
82
+ });
83
+ // ─── Tool ──────────────────────────────────────────────────────────────
84
+ // OpenClaw's tool-hook context often omits sessionKey/runId. Fall back to
85
+ // (agentId → session/run) learned from the most recent llm_input, then to
86
+ // the last-active pair, matching opik's strategy.
87
+ api.on("before_tool_call", (event, toolCtx) => {
88
+ try {
89
+ const ctx = readContext(toolCtx);
90
+ const resolved = resolveToolSession(toolCtx);
91
+ if (!resolved) {
92
+ logger.debug("before_tool_call sessionKey/runId unresolved (no llm_input seen yet); skipping");
93
+ return;
94
+ }
95
+ const evObj = asRecord(event);
96
+ const toolName = nonEmptyString(evObj?.toolName) ?? nonEmptyString(evObj?.name) ?? "unknown";
97
+ const toolCallId = nonEmptyString(evObj?.toolCallId) ??
98
+ nonEmptyString(asRecord(toolCtx)?.toolCallId) ??
99
+ null;
100
+ tracker.openToolSpan({
101
+ sessionKey: resolved.sessionKey,
102
+ runId: resolved.runId,
103
+ emissionSource: "hook",
104
+ toolCallId,
105
+ toolName,
106
+ toolInput: asRecord(evObj?.params) ?? asRecord(evObj?.input),
107
+ ...ctx,
108
+ });
109
+ }
110
+ catch (err) {
111
+ logger.warn("before_tool_call handler failed", { err: errMsg(err) });
112
+ }
113
+ });
114
+ api.on("after_tool_call", (event, toolCtx) => {
115
+ try {
116
+ const ctx = readContext(toolCtx);
117
+ const resolved = resolveToolSession(toolCtx);
118
+ if (!resolved) {
119
+ logger.debug("after_tool_call sessionKey/runId unresolved (no llm_input seen yet); skipping");
120
+ return;
121
+ }
122
+ const evObj = asRecord(event);
123
+ const toolName = nonEmptyString(evObj?.toolName) ?? nonEmptyString(evObj?.name) ?? "unknown";
124
+ const toolCallId = nonEmptyString(evObj?.toolCallId) ??
125
+ nonEmptyString(asRecord(toolCtx)?.toolCallId) ??
126
+ null;
127
+ const error = evObj?.error;
128
+ const result = evObj?.result;
129
+ const durationMs = typeof evObj?.durationMs === "number" ? evObj.durationMs : undefined;
130
+ tracker.finalizeToolSpan({
131
+ sessionKey: resolved.sessionKey,
132
+ runId: resolved.runId,
133
+ toolCallId,
134
+ toolName,
135
+ output: error !== undefined ? undefined : result,
136
+ error: error !== undefined ? error : undefined,
137
+ durationMs,
138
+ ...ctx,
139
+ });
140
+ }
141
+ catch (err) {
142
+ logger.warn("after_tool_call handler failed", { err: errMsg(err) });
143
+ }
144
+ });
145
+ // ─── Subagent (four hooks) ─────────────────────────────────────────────
146
+ api.on("subagent_spawning", (event, subagentCtx) => {
147
+ try {
148
+ const ctx = readContext(subagentCtx);
149
+ const evObj = asRecord(event);
150
+ const ctxObj = asRecord(subagentCtx);
151
+ const hostSessionKey = nonEmptyString(ctxObj?.requesterSessionKey) ??
152
+ nonEmptyString(ctxObj?.sessionKey) ??
153
+ "";
154
+ const hostRunId = nonEmptyString(ctxObj?.runId) ??
155
+ nonEmptyString(ctxObj?.requesterRunId) ??
156
+ "";
157
+ const childSessionKey = nonEmptyString(evObj?.childSessionKey) ??
158
+ nonEmptyString(ctxObj?.childSessionKey);
159
+ if (!childSessionKey) {
160
+ logger.warn("subagent_spawning missing childSessionKey; skipping span");
161
+ return;
162
+ }
163
+ const parentSpanId = hostSessionKey && hostRunId
164
+ ? tracker.getActiveLlmSpanId(hostSessionKey, hostRunId)
165
+ : null;
166
+ tracker.openSubagentSpan({
167
+ hostSessionKey,
168
+ hostRunId,
169
+ childSessionKey,
170
+ parentSpanId,
171
+ input: {
172
+ agentId: evObj?.agentId,
173
+ label: evObj?.label,
174
+ mode: evObj?.mode,
175
+ requester: evObj?.requester,
176
+ threadRequested: evObj?.threadRequested,
177
+ },
178
+ ...ctx,
179
+ });
180
+ }
181
+ catch (err) {
182
+ logger.warn("subagent_spawning handler failed", { err: errMsg(err) });
183
+ }
184
+ });
185
+ api.on("subagent_spawned", (event, subagentCtx) => {
186
+ try {
187
+ const ctx = readContext(subagentCtx);
188
+ const evObj = asRecord(event);
189
+ const ctxObj = asRecord(subagentCtx);
190
+ const childSessionKey = nonEmptyString(evObj?.childSessionKey) ??
191
+ nonEmptyString(ctxObj?.childSessionKey);
192
+ if (!childSessionKey)
193
+ return;
194
+ tracker.mergeSubagentSpan({
195
+ childSessionKey,
196
+ status: "spawned",
197
+ patch: {
198
+ runId: nonEmptyString(evObj?.runId) ?? nonEmptyString(ctxObj?.runId),
199
+ agentId: evObj?.agentId,
200
+ mode: evObj?.mode,
201
+ threadRequested: evObj?.threadRequested,
202
+ },
203
+ }, ctx);
204
+ }
205
+ catch (err) {
206
+ logger.warn("subagent_spawned handler failed", { err: errMsg(err) });
207
+ }
208
+ });
209
+ api.on("subagent_delivery_target", (event, subagentCtx) => {
210
+ try {
211
+ const ctx = readContext(subagentCtx);
212
+ const evObj = asRecord(event);
213
+ const ctxObj = asRecord(subagentCtx);
214
+ const childSessionKey = nonEmptyString(evObj?.childSessionKey) ??
215
+ nonEmptyString(ctxObj?.childSessionKey);
216
+ if (!childSessionKey)
217
+ return;
218
+ const requesterOrigin = asRecord(evObj?.requesterOrigin) ?? {};
219
+ tracker.mergeSubagentSpan({
220
+ childSessionKey,
221
+ status: "delivery_target",
222
+ patch: {
223
+ delivery: {
224
+ channel: nonEmptyString(requesterOrigin.channel),
225
+ accountId: nonEmptyString(requesterOrigin.accountId),
226
+ to: nonEmptyString(requesterOrigin.to),
227
+ threadId: requesterOrigin.threadId,
228
+ childRunId: nonEmptyString(evObj?.childRunId),
229
+ spawnMode: nonEmptyString(evObj?.spawnMode),
230
+ expectsCompletionMessage: typeof evObj?.expectsCompletionMessage === "boolean"
231
+ ? evObj.expectsCompletionMessage
232
+ : undefined,
233
+ },
234
+ },
235
+ }, ctx);
236
+ }
237
+ catch (err) {
238
+ logger.warn("subagent_delivery_target handler failed", { err: errMsg(err) });
239
+ }
240
+ });
241
+ api.on("subagent_ended", (event, subagentCtx) => {
242
+ try {
243
+ const ctx = readContext(subagentCtx);
244
+ const evObj = asRecord(event);
245
+ const ctxObj = asRecord(subagentCtx);
246
+ const childSessionKey = nonEmptyString(evObj?.targetSessionKey) ??
247
+ nonEmptyString(ctxObj?.childSessionKey) ??
248
+ nonEmptyString(evObj?.childSessionKey);
249
+ if (!childSessionKey)
250
+ return;
251
+ const error = evObj?.error;
252
+ tracker.finalizeSubagentSpan({
253
+ childSessionKey,
254
+ status: "ended",
255
+ output: error === undefined
256
+ ? {
257
+ outcome: evObj?.outcome,
258
+ reason: evObj?.reason,
259
+ }
260
+ : undefined,
261
+ error: error !== undefined ? error : undefined,
262
+ }, ctx);
263
+ }
264
+ catch (err) {
265
+ logger.warn("subagent_ended handler failed", { err: errMsg(err) });
266
+ }
267
+ });
268
+ // ─── Agent end (sweep orphans + emit marker) ───────────────────────────
269
+ api.on("agent_end", (event, agentCtx) => {
270
+ try {
271
+ const ctx = readContext(agentCtx);
272
+ const sessionKey = readSessionKey(agentCtx, event);
273
+ const runId = readRunId(agentCtx, event);
274
+ if (!sessionKey || !runId) {
275
+ logger.warn("agent_end missing sessionKey/runId; skipping marker");
276
+ return;
277
+ }
278
+ const evObj = asRecord(event);
279
+ tracker.captureAgentEnd({
280
+ sessionKey,
281
+ runId,
282
+ outcome: evObj?.outcome,
283
+ error: evObj?.error,
284
+ ...ctx,
285
+ });
286
+ }
287
+ catch (err) {
288
+ logger.warn("agent_end handler failed", { err: errMsg(err) });
289
+ }
290
+ });
291
+ }
292
+ // ─── Helpers ──────────────────────────────────────────────────────────────
293
+ function asRecord(v) {
294
+ if (v && typeof v === "object" && !Array.isArray(v)) {
295
+ return v;
296
+ }
297
+ return undefined;
298
+ }
299
+ function nonEmptyString(v) {
300
+ return typeof v === "string" && v.length > 0 ? v : undefined;
301
+ }
302
+ /**
303
+ * Pull senpi-context headers out of agentCtx. Several common locations are
304
+ * checked because the exact shape depends on OpenClaw's runtime extension SDK.
305
+ */
306
+ function readContext(agentCtx) {
307
+ const headers = readHeaders(agentCtx);
308
+ return {
309
+ correlationId: headers[HEADER_CORRELATION_ID] ?? null,
310
+ address: headers[HEADER_ADDRESS] ?? null,
311
+ recipeName: headers[HEADER_RECIPE_NAME] ?? null,
312
+ runtimeId: headers[HEADER_RUNTIME_ID] ?? null,
313
+ runtimeVersion: headers[HEADER_RUNTIME_VERSION] ?? null,
314
+ };
315
+ }
316
+ function readHeaders(agentCtx) {
317
+ const ctxObj = asRecord(agentCtx);
318
+ if (!ctxObj)
319
+ return {};
320
+ const candidates = [
321
+ asRecord(ctxObj.headers),
322
+ asRecord(asRecord(ctxObj.request)?.headers),
323
+ asRecord(ctxObj.requestHeaders),
324
+ asRecord(asRecord(ctxObj.meta)?.headers),
325
+ ];
326
+ const out = {};
327
+ for (const candidate of candidates) {
328
+ if (!candidate)
329
+ continue;
330
+ for (const [k, v] of Object.entries(candidate)) {
331
+ // HTTP headers should be case-insensitive; normalize to lowercase.
332
+ const lk = k.toLowerCase();
333
+ if (typeof v === "string" && v.length > 0 && out[lk] === undefined) {
334
+ out[lk] = v;
335
+ }
336
+ else if (Array.isArray(v) && v.length > 0 && typeof v[0] === "string") {
337
+ out[lk] = v[0];
338
+ }
339
+ }
340
+ }
341
+ return out;
342
+ }
343
+ function readSessionKey(ctx, event) {
344
+ return (nonEmptyString(asRecord(ctx)?.sessionKey) ??
345
+ nonEmptyString(asRecord(ctx)?.sessionId) ??
346
+ nonEmptyString(asRecord(event)?.sessionKey) ??
347
+ nonEmptyString(asRecord(event)?.sessionId));
348
+ }
349
+ function readRunId(ctx, event) {
350
+ return (nonEmptyString(asRecord(ctx)?.runId) ??
351
+ nonEmptyString(asRecord(event)?.runId));
352
+ }
353
+ function extractLlmInput(event) {
354
+ const ev = asRecord(event);
355
+ if (!ev)
356
+ return {};
357
+ // Strip OpenClaw framework metadata blocks (untrusted-context, sender info,
358
+ // reply_to markers, media refs) before stamping the payload onto the span.
359
+ // Without this, every llm_input on a chat session balloons past 1MB on the
360
+ // back of injected context and the real user prompt gets buried.
361
+ return {
362
+ system: sanitizePayloadValue(ev.systemPrompt ?? ev.system),
363
+ prompt: sanitizePayloadValue(ev.prompt),
364
+ messages: sanitizePayloadValue(ev.historyMessages ?? ev.messages),
365
+ model: ev.model,
366
+ provider: ev.provider,
367
+ imagesCount: ev.imagesCount,
368
+ temperature: ev.temperature,
369
+ maxTokens: ev.maxTokens,
370
+ tools: ev.tools,
371
+ };
372
+ }
373
+ function extractLlmOutput(event) {
374
+ const ev = asRecord(event);
375
+ if (!ev)
376
+ return { model: null, tokensIn: null, tokensOut: null };
377
+ const usage = asRecord(ev.usage);
378
+ return {
379
+ output: {
380
+ assistantTexts: sanitizePayloadValue(ev.assistantTexts),
381
+ lastAssistant: sanitizePayloadValue(ev.lastAssistant),
382
+ content: sanitizePayloadValue(ev.content),
383
+ finishReason: ev.finishReason ?? ev.stopReason,
384
+ },
385
+ model: nonEmptyString(ev.model) ?? null,
386
+ // Token field naming varies by provider and by how OpenClaw shapes the
387
+ // usage object. OpenClaw normalizes most hook-path traffic to `input` /
388
+ // `output` (see normalizeUsage in session-cost-usage-*.js), but raw
389
+ // SDK shapes leak through on edge paths and direct-SDK callers. We try
390
+ // every known spelling so the count is captured regardless:
391
+ // Anthropic SDK → input_tokens / output_tokens
392
+ // OpenAI SDK → prompt_tokens / completion_tokens (snake_case is canonical)
393
+ // Wrapper layers → promptTokens / completionTokens (some abstractions)
394
+ // OpenClaw / Gemini → input / output (normalized)
395
+ tokensIn: firstNumber(usage?.input_tokens, usage?.prompt_tokens, usage?.promptTokens, usage?.input),
396
+ tokensOut: firstNumber(usage?.output_tokens, usage?.completion_tokens, usage?.completionTokens, usage?.output),
397
+ };
398
+ }
399
+ function firstNumber(...values) {
400
+ for (const v of values) {
401
+ if (typeof v === "number" && Number.isFinite(v))
402
+ return v;
403
+ }
404
+ return null;
405
+ }
406
+ function errMsg(err) {
407
+ return err instanceof Error ? err.message : String(err);
408
+ }
409
+ //# sourceMappingURL=span-hooks.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"span-hooks.js","sourceRoot":"","sources":["../../../src/tracking/spans/span-hooks.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,MAAM,GAAG,YAAY,CAAC,0BAA0B,CAAC,CAAC;AAkBxD,MAAM,UAAU,iBAAiB,CAAC,OAAiC;IACjE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAEjC,4EAA4E;IAC5E,yEAAyE;IACzE,yEAAyE;IACzE,0EAA0E;IAC1E,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAiD,CAAC;IAElF,IAAI,UAAU,GAAiD,IAAI,CAAC;IACpE,MAAM,eAAe,GAAG,CACtB,QAAiB,EACjB,UAAkB,EAClB,KAAa,EACP,EAAE;QACR,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;QAC5D,IAAI,OAAO;YAAE,gBAAgB,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QAClE,UAAU,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IACrC,CAAC,CAAC;IACF,MAAM,kBAAkB,GAAG,CACzB,GAAY,EACkC,EAAE;QAChD,MAAM,MAAM,GAAG;YACb,UAAU,EAAE,cAAc,CAAC,GAAG,EAAE,SAAS,CAAC;YAC1C,KAAK,EAAE,SAAS,CAAC,GAAG,EAAE,SAAS,CAAC;SACjC,CAAC;QACF,IAAI,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACtC,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QAChE,CAAC;QACD,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;QACvD,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC1C,IAAI,GAAG;gBAAE,OAAO,GAAG,CAAC;QACtB,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;IAEF,0EAA0E;IAC1E,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;QACtC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;YAClC,MAAM,UAAU,GAAG,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YACnD,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YACzC,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC1B,MAAM,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;gBACjE,OAAO;YACT,CAAC;YACD,eAAe,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;YAC7C,OAAO,CAAC,WAAW,CAAC;gBAClB,UAAU;gBACV,KAAK;gBACL,cAAc,EAAE,MAAM;gBACtB,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC;gBAC7B,GAAG,GAAG;aACP,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;QACvC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;YAClC,MAAM,UAAU,GAAG,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YACnD,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YACzC,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC1B,MAAM,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;gBAClE,OAAO;YACT,CAAC;YACD,eAAe,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;YAC7C,MAAM,GAAG,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;YACpC,OAAO,CAAC,eAAe,CAAC;gBACtB,UAAU;gBACV,KAAK;gBACL,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,GAAG,GAAG;aACP,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,0EAA0E;IAC1E,0EAA0E;IAC1E,0EAA0E;IAC1E,kDAAkD;IAClD,GAAG,CAAC,EAAE,CAAC,kBAAkB,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QAC5C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;YACjC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;YAC7C,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,CAAC,KAAK,CACV,gFAAgF,CACjF,CAAC;gBACF,OAAO;YACT,CAAC;YACD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC9B,MAAM,QAAQ,GACZ,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,SAAS,CAAC;YAC9E,MAAM,UAAU,GACd,cAAc,CAAC,KAAK,EAAE,UAAU,CAAC;gBACjC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC;gBAC7C,IAAI,CAAC;YACP,OAAO,CAAC,YAAY,CAAC;gBACnB,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,cAAc,EAAE,MAAM;gBACtB,UAAU;gBACV,QAAQ;gBACR,SAAS,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;gBAC5D,GAAG,GAAG;aACP,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,EAAE,CAAC,iBAAiB,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QAC3C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;YACjC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;YAC7C,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,CAAC,KAAK,CACV,+EAA+E,CAChF,CAAC;gBACF,OAAO;YACT,CAAC;YACD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC9B,MAAM,QAAQ,GACZ,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,SAAS,CAAC;YAC9E,MAAM,UAAU,GACd,cAAc,CAAC,KAAK,EAAE,UAAU,CAAC;gBACjC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC;gBAC7C,IAAI,CAAC;YACP,MAAM,KAAK,GAAG,KAAK,EAAE,KAAK,CAAC;YAC3B,MAAM,MAAM,GAAG,KAAK,EAAE,MAAM,CAAC;YAC7B,MAAM,UAAU,GACd,OAAO,KAAK,EAAE,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;YACvE,OAAO,CAAC,gBAAgB,CAAC;gBACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,UAAU;gBACV,QAAQ;gBACR,MAAM,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;gBAChD,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;gBAC9C,UAAU;gBACV,GAAG,GAAG;aACP,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,gCAAgC,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,0EAA0E;IAC1E,GAAG,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE;QACjD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;YACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC9B,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;YACrC,MAAM,cAAc,GAClB,cAAc,CAAC,MAAM,EAAE,mBAAmB,CAAC;gBAC3C,cAAc,CAAC,MAAM,EAAE,UAAU,CAAC;gBAClC,EAAE,CAAC;YACL,MAAM,SAAS,GACb,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC;gBAC7B,cAAc,CAAC,MAAM,EAAE,cAAc,CAAC;gBACtC,EAAE,CAAC;YACL,MAAM,eAAe,GACnB,cAAc,CAAC,KAAK,EAAE,eAAe,CAAC;gBACtC,cAAc,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;YAC1C,IAAI,CAAC,eAAe,EAAE,CAAC;gBACrB,MAAM,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;gBACxE,OAAO;YACT,CAAC;YACD,MAAM,YAAY,GAChB,cAAc,IAAI,SAAS;gBACzB,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,cAAc,EAAE,SAAS,CAAC;gBACvD,CAAC,CAAC,IAAI,CAAC;YACX,OAAO,CAAC,gBAAgB,CAAC;gBACvB,cAAc;gBACd,SAAS;gBACT,eAAe;gBACf,YAAY;gBACZ,KAAK,EAAE;oBACL,OAAO,EAAE,KAAK,EAAE,OAAO;oBACvB,KAAK,EAAE,KAAK,EAAE,KAAK;oBACnB,IAAI,EAAE,KAAK,EAAE,IAAI;oBACjB,SAAS,EAAE,KAAK,EAAE,SAAS;oBAC3B,eAAe,EAAE,KAAK,EAAE,eAAe;iBACxC;gBACD,GAAG,GAAG;aACP,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,EAAE,CAAC,kBAAkB,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE;QAChD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;YACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC9B,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;YACrC,MAAM,eAAe,GACnB,cAAc,CAAC,KAAK,EAAE,eAAe,CAAC;gBACtC,cAAc,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;YAC1C,IAAI,CAAC,eAAe;gBAAE,OAAO;YAC7B,OAAO,CAAC,iBAAiB,CACvB;gBACE,eAAe;gBACf,MAAM,EAAE,SAAS;gBACjB,KAAK,EAAE;oBACL,KAAK,EAAE,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC;oBACpE,OAAO,EAAE,KAAK,EAAE,OAAO;oBACvB,IAAI,EAAE,KAAK,EAAE,IAAI;oBACjB,eAAe,EAAE,KAAK,EAAE,eAAe;iBACxC;aACF,EACD,GAAG,CACJ,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,EAAE,CAAC,0BAA0B,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE;QACxD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;YACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC9B,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;YACrC,MAAM,eAAe,GACnB,cAAc,CAAC,KAAK,EAAE,eAAe,CAAC;gBACtC,cAAc,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;YAC1C,IAAI,CAAC,eAAe;gBAAE,OAAO;YAC7B,MAAM,eAAe,GAAG,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC,IAAI,EAAE,CAAC;YAC/D,OAAO,CAAC,iBAAiB,CACvB;gBACE,eAAe;gBACf,MAAM,EAAE,iBAAiB;gBACzB,KAAK,EAAE;oBACL,QAAQ,EAAE;wBACR,OAAO,EAAE,cAAc,CAAC,eAAe,CAAC,OAAO,CAAC;wBAChD,SAAS,EAAE,cAAc,CAAC,eAAe,CAAC,SAAS,CAAC;wBACpD,EAAE,EAAE,cAAc,CAAC,eAAe,CAAC,EAAE,CAAC;wBACtC,QAAQ,EAAE,eAAe,CAAC,QAAQ;wBAClC,UAAU,EAAE,cAAc,CAAC,KAAK,EAAE,UAAU,CAAC;wBAC7C,SAAS,EAAE,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC;wBAC3C,wBAAwB,EACtB,OAAO,KAAK,EAAE,wBAAwB,KAAK,SAAS;4BAClD,CAAC,CAAC,KAAK,CAAC,wBAAwB;4BAChC,CAAC,CAAC,SAAS;qBAChB;iBACF;aACF,EACD,GAAG,CACJ,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,yCAAyC,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,EAAE,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE;QAC9C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;YACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC9B,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;YACrC,MAAM,eAAe,GACnB,cAAc,CAAC,KAAK,EAAE,gBAAgB,CAAC;gBACvC,cAAc,CAAC,MAAM,EAAE,eAAe,CAAC;gBACvC,cAAc,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;YACzC,IAAI,CAAC,eAAe;gBAAE,OAAO;YAC7B,MAAM,KAAK,GAAG,KAAK,EAAE,KAAK,CAAC;YAC3B,OAAO,CAAC,oBAAoB,CAC1B;gBACE,eAAe;gBACf,MAAM,EAAE,OAAO;gBACf,MAAM,EACJ,KAAK,KAAK,SAAS;oBACjB,CAAC,CAAC;wBACE,OAAO,EAAE,KAAK,EAAE,OAAO;wBACvB,MAAM,EAAE,KAAK,EAAE,MAAM;qBACtB;oBACH,CAAC,CAAC,SAAS;gBACf,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;aAC/C,EACD,GAAG,CACJ,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,+BAA+B,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,0EAA0E;IAC1E,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;QACtC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;YAClC,MAAM,UAAU,GAAG,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YACnD,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YACzC,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC1B,MAAM,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;gBACnE,OAAO;YACT,CAAC;YACD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC9B,OAAO,CAAC,eAAe,CAAC;gBACtB,UAAU;gBACV,KAAK;gBACL,OAAO,EAAE,KAAK,EAAE,OAAO;gBACvB,KAAK,EAAE,KAAK,EAAE,KAAK;gBACnB,GAAG,GAAG;aACP,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,6EAA6E;AAE7E,SAAS,QAAQ,CAAC,CAAU;IAC1B,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,OAAO,CAA4B,CAAC;IACtC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,cAAc,CAAC,CAAU;IAChC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/D,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAAC,QAAiB;IACpC,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IACtC,OAAO;QACL,aAAa,EAAE,OAAO,CAAC,qBAAqB,CAAC,IAAI,IAAI;QACrD,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,IAAI,IAAI;QACxC,UAAU,EAAE,OAAO,CAAC,kBAAkB,CAAC,IAAI,IAAI;QAC/C,SAAS,EAAE,OAAO,CAAC,iBAAiB,CAAC,IAAI,IAAI;QAC7C,cAAc,EAAE,OAAO,CAAC,sBAAsB,CAAC,IAAI,IAAI;KACxD,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,QAAiB;IACpC,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,MAAM,UAAU,GAA+C;QAC7D,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC;QACxB,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAC3C,QAAQ,CAAC,MAAM,CAAC,cAAc,CAAC;QAC/B,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;KACzC,CAAC;IACF,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC,SAAS;YAAE,SAAS;QACzB,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/C,mEAAmE;YACnE,MAAM,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;YAC3B,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC,KAAK,SAAS,EAAE,CAAC;gBACnE,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;YACd,CAAC;iBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACxE,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,cAAc,CAAC,GAAY,EAAE,KAAc;IAClD,OAAO,CACL,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC;QACzC,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC;QACxC,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;QAC3C,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,CAC3C,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,GAAY,EAAE,KAAc;IAC7C,OAAO,CACL,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC;QACpC,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CACvC,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC3B,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,CAAC;IACnB,4EAA4E;IAC5E,2EAA2E;IAC3E,2EAA2E;IAC3E,iEAAiE;IACjE,OAAO;QACL,MAAM,EAAE,oBAAoB,CAAC,EAAE,CAAC,YAAY,IAAI,EAAE,CAAC,MAAM,CAAC;QAC1D,MAAM,EAAE,oBAAoB,CAAC,EAAE,CAAC,MAAM,CAAC;QACvC,QAAQ,EAAE,oBAAoB,CAAC,EAAE,CAAC,eAAe,IAAI,EAAE,CAAC,QAAQ,CAAC;QACjE,KAAK,EAAE,EAAE,CAAC,KAAK;QACf,QAAQ,EAAE,EAAE,CAAC,QAAQ;QACrB,WAAW,EAAE,EAAE,CAAC,WAAW;QAC3B,WAAW,EAAE,EAAE,CAAC,WAAW;QAC3B,SAAS,EAAE,EAAE,CAAC,SAAS;QACvB,KAAK,EAAE,EAAE,CAAC,KAAK;KAChB,CAAC;AACJ,CAAC;AASD,SAAS,gBAAgB,CAAC,KAAc;IACtC,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC3B,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACjE,MAAM,KAAK,GAAG,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO;QACL,MAAM,EAAE;YACN,cAAc,EAAE,oBAAoB,CAAC,EAAE,CAAC,cAAc,CAAC;YACvD,aAAa,EAAE,oBAAoB,CAAC,EAAE,CAAC,aAAa,CAAC;YACrD,OAAO,EAAE,oBAAoB,CAAC,EAAE,CAAC,OAAO,CAAC;YACzC,YAAY,EAAE,EAAE,CAAC,YAAY,IAAI,EAAE,CAAC,UAAU;SAC/C;QACD,KAAK,EAAE,cAAc,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,IAAI;QACvC,uEAAuE;QACvE,wEAAwE;QACxE,oEAAoE;QACpE,uEAAuE;QACvE,4DAA4D;QAC5D,sDAAsD;QACtD,uFAAuF;QACvF,iFAAiF;QACjF,2EAA2E;QAC3E,QAAQ,EAAE,WAAW,CACnB,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,KAAK,CACb;QACD,SAAS,EAAE,WAAW,CACpB,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,iBAAiB,EACxB,KAAK,EAAE,gBAAgB,EACvB,KAAK,EAAE,MAAM,CACd;KACF,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,GAAG,MAAiB;IACvC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,MAAM,CAAC,GAAY;IAC1B,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC"}
@@ -0,0 +1,133 @@
1
+ import type { EmissionSource, SpanTransport } from "./types.js";
2
+ export interface SpanContextFields {
3
+ correlationId?: string | null;
4
+ address?: string | null;
5
+ recipeName?: string | null;
6
+ runtimeId?: string | null;
7
+ runtimeVersion?: string | null;
8
+ }
9
+ export interface OpenLlmSpanInput extends SpanContextFields {
10
+ sessionKey: string;
11
+ runId: string;
12
+ emissionSource: EmissionSource;
13
+ startedAt?: number;
14
+ input: Record<string, unknown>;
15
+ }
16
+ export interface FinalizeLlmSpanInput extends SpanContextFields {
17
+ sessionKey: string;
18
+ runId: string;
19
+ output?: Record<string, unknown>;
20
+ error?: unknown;
21
+ model?: string | null;
22
+ tokensIn?: number | null;
23
+ tokensOut?: number | null;
24
+ costUsd?: number | null;
25
+ }
26
+ export interface OpenToolSpanInput extends SpanContextFields {
27
+ sessionKey: string;
28
+ runId: string;
29
+ emissionSource: EmissionSource;
30
+ toolCallId: string | null;
31
+ toolName: string;
32
+ toolInput?: Record<string, unknown>;
33
+ startedAt?: number;
34
+ }
35
+ export interface FinalizeToolSpanInput extends SpanContextFields {
36
+ sessionKey: string;
37
+ runId: string;
38
+ toolCallId: string | null;
39
+ toolName: string;
40
+ output?: unknown;
41
+ error?: unknown;
42
+ durationMs?: number;
43
+ }
44
+ export interface DirectLlmSpanInput extends SpanContextFields {
45
+ sessionKey: string;
46
+ runId: string;
47
+ startedAt: number;
48
+ endedAt: number;
49
+ model?: string | null;
50
+ tokensIn?: number | null;
51
+ tokensOut?: number | null;
52
+ costUsd?: number | null;
53
+ input: Record<string, unknown>;
54
+ output?: Record<string, unknown>;
55
+ error?: unknown;
56
+ parentSpanId?: string | null;
57
+ }
58
+ export interface DirectToolSpanInput extends SpanContextFields {
59
+ sessionKey: string;
60
+ runId: string;
61
+ toolCallId?: string | null;
62
+ toolName: string;
63
+ startedAt: number;
64
+ endedAt: number;
65
+ input?: Record<string, unknown>;
66
+ output?: unknown;
67
+ error?: unknown;
68
+ parentSpanId?: string | null;
69
+ }
70
+ export interface OpenSubagentInput extends SpanContextFields {
71
+ hostSessionKey: string;
72
+ hostRunId: string;
73
+ childSessionKey: string;
74
+ parentSpanId: string | null;
75
+ input: Record<string, unknown>;
76
+ startedAt?: number;
77
+ }
78
+ export interface MergeSubagentInput {
79
+ childSessionKey: string;
80
+ /** Status to record (e.g., "spawned", "delivery_target"). */
81
+ status: string;
82
+ /** Additional fields to merge into `data` (e.g., delivery metadata). */
83
+ patch?: Record<string, unknown>;
84
+ }
85
+ export interface FinalizeSubagentInput {
86
+ childSessionKey: string;
87
+ status: string;
88
+ output?: Record<string, unknown>;
89
+ error?: unknown;
90
+ }
91
+ export interface AgentEndInput extends SpanContextFields {
92
+ sessionKey: string;
93
+ runId: string;
94
+ outcome?: unknown;
95
+ error?: unknown;
96
+ }
97
+ export interface SpanTrackerOptions {
98
+ transport: SpanTransport;
99
+ /** Override Date.now for tests. */
100
+ now?: () => number;
101
+ staleTimeoutMs?: number;
102
+ sweepIntervalMs?: number;
103
+ /** Start the periodic stale sweeper. Set false in tests for determinism. */
104
+ enableSweeper?: boolean;
105
+ }
106
+ export declare class SpanTracker {
107
+ private readonly transport;
108
+ private readonly now;
109
+ private readonly staleTimeoutMs;
110
+ private readonly openSpans;
111
+ private readonly openSubagents;
112
+ private toolSeq;
113
+ private sweepTimer;
114
+ constructor(options: SpanTrackerOptions);
115
+ openLlmSpan(input: OpenLlmSpanInput): string;
116
+ finalizeLlmSpan(input: FinalizeLlmSpanInput): void;
117
+ /** Returns the id of the currently-open LLM span for (session, run), or null. */
118
+ getActiveLlmSpanId(sessionKey: string, runId: string): string | null;
119
+ openToolSpan(input: OpenToolSpanInput): string;
120
+ finalizeToolSpan(input: FinalizeToolSpanInput): void;
121
+ openSubagentSpan(input: OpenSubagentInput): string;
122
+ /** Merge fields into an existing subagent (e.g., on _spawned, _delivery_target). Lazy-creates if missing. */
123
+ mergeSubagentSpan(input: MergeSubagentInput, context?: SpanContextFields): void;
124
+ finalizeSubagentSpan(input: FinalizeSubagentInput, context?: SpanContextFields): void;
125
+ captureAgentEnd(input: AgentEndInput): void;
126
+ captureLlmSpan(input: DirectLlmSpanInput): void;
127
+ captureToolSpan(input: DirectToolSpanInput): void;
128
+ sweepStale(): void;
129
+ shutdown(): Promise<void>;
130
+ private enqueueOrphan;
131
+ private enqueueSubagentOrphan;
132
+ }
133
+ //# sourceMappingURL=span-tracker.d.ts.map