@microsoft/opentelemetry 1.1.0 → 1.2.0

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 (206) hide show
  1. package/README.md +15 -14
  2. package/dist/commonjs/a365/configuration/A365Configuration.js +2 -2
  3. package/dist/commonjs/a365/configuration/A365Configuration.js.map +1 -1
  4. package/dist/commonjs/a365/configuration/A365ConfigurationOptions.d.ts +1 -1
  5. package/dist/commonjs/a365/constants.d.ts +109 -2
  6. package/dist/commonjs/a365/constants.d.ts.map +1 -1
  7. package/dist/commonjs/a365/constants.js +108 -1
  8. package/dist/commonjs/a365/constants.js.map +1 -1
  9. package/dist/commonjs/a365/contracts.d.ts +138 -0
  10. package/dist/commonjs/a365/contracts.d.ts.map +1 -1
  11. package/dist/commonjs/a365/contracts.js +33 -0
  12. package/dist/commonjs/a365/contracts.js.map +1 -1
  13. package/dist/commonjs/a365/exporter/Agent365Exporter.d.ts +33 -1
  14. package/dist/commonjs/a365/exporter/Agent365Exporter.d.ts.map +1 -1
  15. package/dist/commonjs/a365/exporter/Agent365Exporter.js +83 -4
  16. package/dist/commonjs/a365/exporter/Agent365Exporter.js.map +1 -1
  17. package/dist/commonjs/a365/exporter/Agent365ExporterOptions.d.ts +8 -0
  18. package/dist/commonjs/a365/exporter/Agent365ExporterOptions.d.ts.map +1 -1
  19. package/dist/commonjs/a365/exporter/Agent365ExporterOptions.js.map +1 -1
  20. package/dist/commonjs/a365/exporter/ExporterEventNames.d.ts +3 -0
  21. package/dist/commonjs/a365/exporter/ExporterEventNames.d.ts.map +1 -1
  22. package/dist/commonjs/a365/exporter/ExporterEventNames.js +3 -0
  23. package/dist/commonjs/a365/exporter/ExporterEventNames.js.map +1 -1
  24. package/dist/commonjs/a365/hosting/agenticTokenCache.d.ts +24 -0
  25. package/dist/commonjs/a365/hosting/agenticTokenCache.d.ts.map +1 -1
  26. package/dist/commonjs/a365/hosting/agenticTokenCache.js +40 -3
  27. package/dist/commonjs/a365/hosting/agenticTokenCache.js.map +1 -1
  28. package/dist/commonjs/a365/hosting/types.d.ts +47 -1
  29. package/dist/commonjs/a365/hosting/types.d.ts.map +1 -1
  30. package/dist/commonjs/a365/scopes/OpenTelemetryScope.d.ts +1 -1
  31. package/dist/commonjs/a365/scopes/OpenTelemetryScope.js +1 -1
  32. package/dist/commonjs/azureMonitor/index.d.ts +2 -2
  33. package/dist/commonjs/azureMonitor/logs/handler.d.ts +3 -3
  34. package/dist/commonjs/azureMonitor/logs/handler.js +3 -3
  35. package/dist/commonjs/azureMonitor/metrics/handler.d.ts +1 -1
  36. package/dist/commonjs/azureMonitor/metrics/handler.js +1 -1
  37. package/dist/commonjs/azureMonitor/metrics/performanceCounters.d.ts +2 -2
  38. package/dist/commonjs/azureMonitor/metrics/performanceCounters.js +2 -2
  39. package/dist/commonjs/azureMonitor/metrics/quickpulse/filtering/validator.js +2 -2
  40. package/dist/commonjs/azureMonitor/metrics/quickpulse/filtering/validator.js.map +1 -1
  41. package/dist/commonjs/azureMonitor/metrics/quickpulse/liveMetrics.d.ts +3 -3
  42. package/dist/commonjs/azureMonitor/metrics/quickpulse/liveMetrics.d.ts.map +1 -1
  43. package/dist/commonjs/azureMonitor/metrics/quickpulse/liveMetrics.js +21 -9
  44. package/dist/commonjs/azureMonitor/metrics/quickpulse/liveMetrics.js.map +1 -1
  45. package/dist/commonjs/azureMonitor/metrics/quickpulse/utils.js +1 -1
  46. package/dist/commonjs/azureMonitor/metrics/quickpulse/utils.js.map +1 -1
  47. package/dist/commonjs/azureMonitor/metrics/standardMetrics.d.ts +1 -1
  48. package/dist/commonjs/azureMonitor/metrics/standardMetrics.js +1 -1
  49. package/dist/commonjs/distro/autoAttach.js +2 -2
  50. package/dist/commonjs/distro/autoAttach.js.map +1 -1
  51. package/dist/commonjs/distro/distro.d.ts +2 -2
  52. package/dist/commonjs/distro/distro.js +5 -5
  53. package/dist/commonjs/distro/distro.js.map +1 -1
  54. package/dist/commonjs/distro/instrumentations.d.ts +2 -2
  55. package/dist/commonjs/distro/instrumentations.js +2 -2
  56. package/dist/commonjs/distro/loader.d.ts +1 -1
  57. package/dist/commonjs/distro/loader.js +1 -1
  58. package/dist/commonjs/genai/instrumentations/langchain/langchainTraceInstrumentor.d.ts +1 -1
  59. package/dist/commonjs/genai/instrumentations/langchain/langchainTraceInstrumentor.d.ts.map +1 -1
  60. package/dist/commonjs/genai/instrumentations/langchain/langchainTraceInstrumentor.js +11 -54
  61. package/dist/commonjs/genai/instrumentations/langchain/langchainTraceInstrumentor.js.map +1 -1
  62. package/dist/commonjs/genai/mainAgent/constants.d.ts +5 -0
  63. package/dist/commonjs/genai/mainAgent/constants.d.ts.map +1 -1
  64. package/dist/commonjs/genai/mainAgent/constants.js +5 -0
  65. package/dist/commonjs/genai/mainAgent/constants.js.map +1 -1
  66. package/dist/commonjs/genai/mainAgent/processor.d.ts +25 -0
  67. package/dist/commonjs/genai/mainAgent/processor.d.ts.map +1 -1
  68. package/dist/commonjs/genai/mainAgent/processor.js +25 -0
  69. package/dist/commonjs/genai/mainAgent/processor.js.map +1 -1
  70. package/dist/commonjs/otlp/handler.d.ts.map +1 -1
  71. package/dist/commonjs/otlp/handler.js +3 -20
  72. package/dist/commonjs/otlp/handler.js.map +1 -1
  73. package/dist/commonjs/sdkstats/constants.d.ts +45 -0
  74. package/dist/commonjs/sdkstats/constants.d.ts.map +1 -0
  75. package/dist/commonjs/sdkstats/constants.js +77 -0
  76. package/dist/commonjs/sdkstats/constants.js.map +1 -0
  77. package/dist/commonjs/sdkstats/index.d.ts +5 -6
  78. package/dist/commonjs/sdkstats/index.d.ts.map +1 -1
  79. package/dist/commonjs/sdkstats/index.js +15 -8
  80. package/dist/commonjs/sdkstats/index.js.map +1 -1
  81. package/dist/commonjs/sdkstats/manager.js +7 -7
  82. package/dist/commonjs/sdkstats/manager.js.map +1 -1
  83. package/dist/commonjs/sdkstats/metrics.d.ts.map +1 -1
  84. package/dist/commonjs/sdkstats/metrics.js +41 -7
  85. package/dist/commonjs/sdkstats/metrics.js.map +1 -1
  86. package/dist/commonjs/sdkstats/networkStats.d.ts +38 -16
  87. package/dist/commonjs/sdkstats/networkStats.d.ts.map +1 -1
  88. package/dist/commonjs/sdkstats/networkStats.js +95 -30
  89. package/dist/commonjs/sdkstats/networkStats.js.map +1 -1
  90. package/dist/commonjs/sdkstats/state.d.ts +5 -5
  91. package/dist/commonjs/sdkstats/state.js +3 -3
  92. package/dist/commonjs/sdkstats/state.js.map +1 -1
  93. package/dist/commonjs/shared/config.d.ts +1 -1
  94. package/dist/commonjs/shared/config.js +1 -1
  95. package/dist/commonjs/types.d.ts +3 -3
  96. package/dist/commonjs/types.js +2 -2
  97. package/dist/commonjs/utils/sdkStats.d.ts.map +1 -1
  98. package/dist/commonjs/utils/sdkStats.js +14 -3
  99. package/dist/commonjs/utils/sdkStats.js.map +1 -1
  100. package/dist/esm/a365/configuration/A365Configuration.js +2 -2
  101. package/dist/esm/a365/configuration/A365Configuration.js.map +1 -1
  102. package/dist/esm/a365/configuration/A365ConfigurationOptions.d.ts +1 -1
  103. package/dist/esm/a365/constants.d.ts +109 -2
  104. package/dist/esm/a365/constants.d.ts.map +1 -1
  105. package/dist/esm/a365/constants.js +108 -1
  106. package/dist/esm/a365/constants.js.map +1 -1
  107. package/dist/esm/a365/contracts.d.ts +138 -0
  108. package/dist/esm/a365/contracts.d.ts.map +1 -1
  109. package/dist/esm/a365/contracts.js +33 -0
  110. package/dist/esm/a365/contracts.js.map +1 -1
  111. package/dist/esm/a365/exporter/Agent365Exporter.d.ts +33 -1
  112. package/dist/esm/a365/exporter/Agent365Exporter.d.ts.map +1 -1
  113. package/dist/esm/a365/exporter/Agent365Exporter.js +84 -5
  114. package/dist/esm/a365/exporter/Agent365Exporter.js.map +1 -1
  115. package/dist/esm/a365/exporter/Agent365ExporterOptions.d.ts +8 -0
  116. package/dist/esm/a365/exporter/Agent365ExporterOptions.d.ts.map +1 -1
  117. package/dist/esm/a365/exporter/Agent365ExporterOptions.js.map +1 -1
  118. package/dist/esm/a365/exporter/ExporterEventNames.d.ts +3 -0
  119. package/dist/esm/a365/exporter/ExporterEventNames.d.ts.map +1 -1
  120. package/dist/esm/a365/exporter/ExporterEventNames.js +3 -0
  121. package/dist/esm/a365/exporter/ExporterEventNames.js.map +1 -1
  122. package/dist/esm/a365/hosting/agenticTokenCache.d.ts +24 -0
  123. package/dist/esm/a365/hosting/agenticTokenCache.d.ts.map +1 -1
  124. package/dist/esm/a365/hosting/agenticTokenCache.js +40 -3
  125. package/dist/esm/a365/hosting/agenticTokenCache.js.map +1 -1
  126. package/dist/esm/a365/hosting/types.d.ts +47 -1
  127. package/dist/esm/a365/hosting/types.d.ts.map +1 -1
  128. package/dist/esm/a365/scopes/OpenTelemetryScope.d.ts +1 -1
  129. package/dist/esm/a365/scopes/OpenTelemetryScope.js +1 -1
  130. package/dist/esm/azureMonitor/index.d.ts +2 -2
  131. package/dist/esm/azureMonitor/logs/handler.d.ts +3 -3
  132. package/dist/esm/azureMonitor/logs/handler.js +3 -3
  133. package/dist/esm/azureMonitor/metrics/handler.d.ts +1 -1
  134. package/dist/esm/azureMonitor/metrics/handler.js +1 -1
  135. package/dist/esm/azureMonitor/metrics/performanceCounters.d.ts +2 -2
  136. package/dist/esm/azureMonitor/metrics/performanceCounters.js +2 -2
  137. package/dist/esm/azureMonitor/metrics/quickpulse/filtering/validator.js +2 -2
  138. package/dist/esm/azureMonitor/metrics/quickpulse/filtering/validator.js.map +1 -1
  139. package/dist/esm/azureMonitor/metrics/quickpulse/liveMetrics.d.ts +3 -3
  140. package/dist/esm/azureMonitor/metrics/quickpulse/liveMetrics.d.ts.map +1 -1
  141. package/dist/esm/azureMonitor/metrics/quickpulse/liveMetrics.js +21 -9
  142. package/dist/esm/azureMonitor/metrics/quickpulse/liveMetrics.js.map +1 -1
  143. package/dist/esm/azureMonitor/metrics/quickpulse/utils.js +1 -1
  144. package/dist/esm/azureMonitor/metrics/quickpulse/utils.js.map +1 -1
  145. package/dist/esm/azureMonitor/metrics/standardMetrics.d.ts +1 -1
  146. package/dist/esm/azureMonitor/metrics/standardMetrics.js +1 -1
  147. package/dist/esm/distro/autoAttach.js +2 -2
  148. package/dist/esm/distro/autoAttach.js.map +1 -1
  149. package/dist/esm/distro/distro.d.ts +2 -2
  150. package/dist/esm/distro/distro.js +5 -5
  151. package/dist/esm/distro/distro.js.map +1 -1
  152. package/dist/esm/distro/instrumentations.d.ts +2 -2
  153. package/dist/esm/distro/instrumentations.js +2 -2
  154. package/dist/esm/distro/loader.d.ts +1 -1
  155. package/dist/esm/distro/loader.js +1 -1
  156. package/dist/esm/genai/instrumentations/langchain/langchainTraceInstrumentor.d.ts +1 -1
  157. package/dist/esm/genai/instrumentations/langchain/langchainTraceInstrumentor.d.ts.map +1 -1
  158. package/dist/esm/genai/instrumentations/langchain/langchainTraceInstrumentor.js +11 -21
  159. package/dist/esm/genai/instrumentations/langchain/langchainTraceInstrumentor.js.map +1 -1
  160. package/dist/esm/genai/mainAgent/constants.d.ts +5 -0
  161. package/dist/esm/genai/mainAgent/constants.d.ts.map +1 -1
  162. package/dist/esm/genai/mainAgent/constants.js +5 -0
  163. package/dist/esm/genai/mainAgent/constants.js.map +1 -1
  164. package/dist/esm/genai/mainAgent/processor.d.ts +25 -0
  165. package/dist/esm/genai/mainAgent/processor.d.ts.map +1 -1
  166. package/dist/esm/genai/mainAgent/processor.js +25 -0
  167. package/dist/esm/genai/mainAgent/processor.js.map +1 -1
  168. package/dist/esm/otlp/handler.d.ts.map +1 -1
  169. package/dist/esm/otlp/handler.js +3 -20
  170. package/dist/esm/otlp/handler.js.map +1 -1
  171. package/dist/esm/sdkstats/constants.d.ts +45 -0
  172. package/dist/esm/sdkstats/constants.d.ts.map +1 -0
  173. package/dist/esm/sdkstats/constants.js +74 -0
  174. package/dist/esm/sdkstats/constants.js.map +1 -0
  175. package/dist/esm/sdkstats/index.d.ts +5 -6
  176. package/dist/esm/sdkstats/index.d.ts.map +1 -1
  177. package/dist/esm/sdkstats/index.js +4 -5
  178. package/dist/esm/sdkstats/index.js.map +1 -1
  179. package/dist/esm/sdkstats/manager.js +7 -7
  180. package/dist/esm/sdkstats/manager.js.map +1 -1
  181. package/dist/esm/sdkstats/metrics.d.ts.map +1 -1
  182. package/dist/esm/sdkstats/metrics.js +42 -8
  183. package/dist/esm/sdkstats/metrics.js.map +1 -1
  184. package/dist/esm/sdkstats/networkStats.d.ts +38 -16
  185. package/dist/esm/sdkstats/networkStats.d.ts.map +1 -1
  186. package/dist/esm/sdkstats/networkStats.js +79 -26
  187. package/dist/esm/sdkstats/networkStats.js.map +1 -1
  188. package/dist/esm/sdkstats/state.d.ts +5 -5
  189. package/dist/esm/sdkstats/state.js +3 -3
  190. package/dist/esm/sdkstats/state.js.map +1 -1
  191. package/dist/esm/shared/config.d.ts +1 -1
  192. package/dist/esm/shared/config.js +1 -1
  193. package/dist/esm/types.d.ts +3 -3
  194. package/dist/esm/types.js +2 -2
  195. package/dist/esm/utils/sdkStats.d.ts.map +1 -1
  196. package/dist/esm/utils/sdkStats.js +14 -3
  197. package/dist/esm/utils/sdkStats.js.map +1 -1
  198. package/package.json +28 -19
  199. package/dist/commonjs/sdkstats/otlpWrapper.d.ts +0 -56
  200. package/dist/commonjs/sdkstats/otlpWrapper.d.ts.map +0 -1
  201. package/dist/commonjs/sdkstats/otlpWrapper.js +0 -121
  202. package/dist/commonjs/sdkstats/otlpWrapper.js.map +0 -1
  203. package/dist/esm/sdkstats/otlpWrapper.d.ts +0 -56
  204. package/dist/esm/sdkstats/otlpWrapper.d.ts.map +0 -1
  205. package/dist/esm/sdkstats/otlpWrapper.js +0 -115
  206. package/dist/esm/sdkstats/otlpWrapper.js.map +0 -1
@@ -9,119 +9,179 @@ import type { SpanKind, TimeInput, Link, Context, TraceState } from "@openteleme
9
9
  export declare const DEFAULT_FINISH_REASON: "stop";
10
10
  /** Role of a message participant per OTEL gen-ai semantic conventions. */
11
11
  export declare enum MessageRole {
12
+ /** A system / developer instruction message. */
12
13
  SYSTEM = "system",
14
+ /** A message authored by the end user. */
13
15
  USER = "user",
16
+ /** A message authored by the model/assistant. */
14
17
  ASSISTANT = "assistant",
18
+ /** A message containing the result of a tool call. */
15
19
  TOOL = "tool"
16
20
  }
17
21
  /** Reason a model stopped generating per OTEL gen-ai semantic conventions. */
18
22
  export declare enum FinishReason {
23
+ /** The model reached a natural stopping point or a provided stop sequence. */
19
24
  STOP = "stop",
25
+ /** Generation stopped because the maximum token limit was reached. */
20
26
  LENGTH = "length",
27
+ /** Generation was stopped by a content filter. */
21
28
  CONTENT_FILTER = "content_filter",
29
+ /** The model emitted a tool call and is awaiting its result. */
22
30
  TOOL_CALL = "tool_call",
31
+ /** Generation stopped because of an error. */
23
32
  ERROR = "error"
24
33
  }
25
34
  /** Media modality for blob, file, and URI parts. */
26
35
  export declare enum Modality {
36
+ /** Image content. */
27
37
  IMAGE = "image",
38
+ /** Video content. */
28
39
  VIDEO = "video",
40
+ /** Audio content. */
29
41
  AUDIO = "audio"
30
42
  }
31
43
  /** Represents different roles that can invoke an agent. */
32
44
  export declare enum InvocationRole {
45
+ /** The agent was invoked by a human user. */
33
46
  Human = "Human",
47
+ /** The agent was invoked by another agent. */
34
48
  Agent = "Agent",
49
+ /** The agent was invoked by a system event or trigger. */
35
50
  Event = "Event",
51
+ /** The invoking role could not be determined. */
36
52
  Unknown = "Unknown"
37
53
  }
38
54
  /** Represents different operation types for model inference. */
39
55
  export declare enum InferenceOperationType {
56
+ /** A chat-completion request. */
40
57
  CHAT = "Chat",
58
+ /** A text-completion request. */
41
59
  TEXT_COMPLETION = "TextCompletion",
60
+ /** A multimodal content-generation request. */
42
61
  GENERATE_CONTENT = "GenerateContent"
43
62
  }
44
63
  /** Plain text content. */
45
64
  export interface TextPart {
65
+ /** Discriminator identifying this as a text part. */
46
66
  type: "text";
67
+ /** The text content. */
47
68
  content: string;
48
69
  }
49
70
  /** A tool call requested by the model. */
50
71
  export interface ToolCallRequestPart {
72
+ /** Discriminator identifying this as a tool-call request part. */
51
73
  type: "tool_call";
74
+ /** The name of the tool being called. */
52
75
  name: string;
76
+ /** Unique identifier correlating this call with its response. */
53
77
  id?: string;
78
+ /** Arguments passed to the tool, as an object or positional array. */
54
79
  arguments?: Record<string, unknown> | unknown[];
55
80
  }
56
81
  /** Result of a tool call. */
57
82
  export interface ToolCallResponsePart {
83
+ /** Discriminator identifying this as a tool-call response part. */
58
84
  type: "tool_call_response";
85
+ /** Identifier of the originating tool call. */
59
86
  id?: string;
87
+ /** The value returned by the tool. */
60
88
  response?: unknown;
61
89
  }
62
90
  /** Model reasoning / chain-of-thought content. */
63
91
  export interface ReasoningPart {
92
+ /** Discriminator identifying this as a reasoning part. */
64
93
  type: "reasoning";
94
+ /** The reasoning / chain-of-thought text. */
65
95
  content: string;
66
96
  }
67
97
  /** Inline binary data (base64-encoded). */
68
98
  export interface BlobPart {
99
+ /** Discriminator identifying this as an inline blob part. */
69
100
  type: "blob";
101
+ /** Media modality of the content (e.g. image, audio, video). */
70
102
  modality: Modality | string;
103
+ /** MIME type of the content (e.g. `image/png`). */
71
104
  mime_type?: string;
105
+ /** Base64-encoded binary content. */
72
106
  content: string;
73
107
  }
74
108
  /** Reference to a pre-uploaded file. */
75
109
  export interface FilePart {
110
+ /** Discriminator identifying this as a file-reference part. */
76
111
  type: "file";
112
+ /** Media modality of the referenced file. */
77
113
  modality: Modality | string;
114
+ /** MIME type of the referenced file. */
78
115
  mime_type?: string;
116
+ /** Identifier of the pre-uploaded file. */
79
117
  file_id: string;
80
118
  }
81
119
  /** External URI reference. */
82
120
  export interface UriPart {
121
+ /** Discriminator identifying this as a URI-reference part. */
83
122
  type: "uri";
123
+ /** Media modality of the referenced content. */
84
124
  modality: Modality | string;
125
+ /** MIME type of the referenced content. */
85
126
  mime_type?: string;
127
+ /** The external URI of the content. */
86
128
  uri: string;
87
129
  }
88
130
  /** Extensible server tool call details. */
89
131
  export interface GenericServerToolCall {
132
+ /** The server tool-call type discriminator. */
90
133
  type: string;
134
+ /** Additional, provider-specific server tool-call fields. */
91
135
  [key: string]: unknown;
92
136
  }
93
137
  /** Extensible server tool call response. */
94
138
  export interface GenericServerToolCallResponse {
139
+ /** The server tool-call response type discriminator. */
95
140
  type: string;
141
+ /** Additional, provider-specific server tool-call response fields. */
96
142
  [key: string]: unknown;
97
143
  }
98
144
  /** Server-side tool invocation. */
99
145
  export interface ServerToolCallPart {
146
+ /** Discriminator identifying this as a server tool-call part. */
100
147
  type: "server_tool_call";
148
+ /** The name of the server-side tool being called. */
101
149
  name: string;
150
+ /** Unique identifier correlating this call with its response. */
102
151
  id?: string;
152
+ /** The server tool-call details. */
103
153
  server_tool_call: GenericServerToolCall;
104
154
  }
105
155
  /** Server-side tool response. */
106
156
  export interface ServerToolCallResponsePart {
157
+ /** Discriminator identifying this as a server tool-call response part. */
107
158
  type: "server_tool_call_response";
159
+ /** Identifier of the originating server tool call. */
108
160
  id?: string;
161
+ /** The server tool-call response details. */
109
162
  server_tool_call_response: GenericServerToolCallResponse;
110
163
  }
111
164
  /** Extensible part for custom / future types. */
112
165
  export interface GenericPart {
166
+ /** The part type discriminator. */
113
167
  type: string;
168
+ /** Additional, custom part fields. */
114
169
  [key: string]: unknown;
115
170
  }
116
171
  /** Union of all message part types per OTEL gen-ai semantic conventions. */
117
172
  export type MessagePart = TextPart | ToolCallRequestPart | ToolCallResponsePart | ReasoningPart | BlobPart | FilePart | UriPart | ServerToolCallPart | ServerToolCallResponsePart | GenericPart;
118
173
  /** An input message sent to a model (OTEL gen-ai semantic conventions). */
119
174
  export interface ChatMessage {
175
+ /** Role of the message author (e.g. `user`, `assistant`). */
120
176
  role: MessageRole | string;
177
+ /** Ordered list of content parts that make up the message. */
121
178
  parts: MessagePart[];
179
+ /** Optional display name of the message author. */
122
180
  name?: string;
123
181
  }
182
+ /** A structured wrapper around the list of input messages. */
124
183
  export interface InputMessages {
184
+ /** The input messages, in order. */
125
185
  messages: ChatMessage[];
126
186
  }
127
187
  /**
@@ -129,9 +189,12 @@ export interface InputMessages {
129
189
  * `finish_reason` defaults to `"stop"` per OTel spec when not provided.
130
190
  */
131
191
  export interface OutputMessage extends ChatMessage {
192
+ /** Reason the model stopped generating this message. Defaults to `"stop"`. */
132
193
  finish_reason?: FinishReason | string;
133
194
  }
195
+ /** A structured wrapper around the list of output messages. */
134
196
  export interface OutputMessages {
197
+ /** The output messages, in order. */
135
198
  messages: OutputMessage[];
136
199
  }
137
200
  /** Accepted input for `recordInputMessages`. Supports a single string, an array of strings (backward compat), or the structured wrapper. */
@@ -142,39 +205,64 @@ export type OutputMessagesParam = string | string[] | OutputMessages;
142
205
  export type ResponseMessagesParam = OutputMessagesParam | Record<string, unknown>;
143
206
  /** Represents a channel for an invocation. */
144
207
  export interface Channel {
208
+ /** Unique identifier of the channel. */
145
209
  id?: string;
210
+ /** Display name of the channel (e.g. `Microsoft Teams`). */
146
211
  name?: string;
212
+ /** URI of the channel's icon. */
147
213
  iconUri?: string;
214
+ /** Role that the channel plays in the invocation. */
148
215
  role?: InvocationRole;
216
+ /** Human-readable description or deep link for the channel. */
149
217
  description?: string;
150
218
  }
151
219
  /** Represents a request with telemetry context. */
152
220
  export interface Request {
221
+ /** The input content (prompt / messages) for the request. */
153
222
  content?: InputMessagesParam;
223
+ /** Identifier of the session this request belongs to. */
154
224
  sessionId?: string;
225
+ /** The channel the request originated from. */
155
226
  channel?: Channel;
227
+ /** Identifier of the conversation this request belongs to. */
156
228
  conversationId?: string;
157
229
  }
158
230
  /** Details about an AI agent. */
159
231
  export interface AgentDetails {
232
+ /** Unique identifier of the agent (required). */
160
233
  agentId: string;
234
+ /** Display name of the agent. */
161
235
  agentName?: string;
236
+ /** Human-readable description of the agent. */
162
237
  agentDescription?: string;
238
+ /** URI of the agent's icon. */
163
239
  iconUri?: string;
240
+ /** Identifier of the platform hosting the agent. */
164
241
  platformId?: string;
242
+ /** Agentic user identifier (AAD Object ID) associated with the agent. */
165
243
  agentAUID?: string;
244
+ /** Email address associated with the agentic user. */
166
245
  agentEmail?: string;
246
+ /** Identifier of the blueprint the agent was created from. */
167
247
  agentBlueprintId?: string;
248
+ /** Identifier of the tenant that owns the agent. */
168
249
  tenantId?: string;
250
+ /** Name of the provider that hosts the agent. */
169
251
  providerName?: string;
252
+ /** Version of the agent. */
170
253
  agentVersion?: string;
171
254
  }
172
255
  /** Details about the human user caller. */
173
256
  export interface UserDetails {
257
+ /** Unique identifier of the user. */
174
258
  userId?: string;
259
+ /** Email address of the user. */
175
260
  userEmail?: string;
261
+ /** Display name of the user. */
176
262
  userName?: string;
263
+ /** Identifier of the tenant the user belongs to. */
177
264
  tenantId?: string;
265
+ /** Client IP address of the caller. */
178
266
  callerClientIp?: string;
179
267
  }
180
268
  /**
@@ -182,69 +270,105 @@ export interface UserDetails {
182
270
  * Supports human callers, agent callers, or both (A2A with a human in the chain).
183
271
  */
184
272
  export interface CallerDetails {
273
+ /** Identity details of the human user caller. */
185
274
  userDetails?: UserDetails;
275
+ /** Identity details of the calling agent (for agent-to-agent scenarios). */
186
276
  callerAgentDetails?: AgentDetails;
187
277
  }
188
278
  /** Represents an endpoint for agent invocation. */
189
279
  export interface ServiceEndpoint {
280
+ /** Host name or IP address of the endpoint. */
190
281
  host: string;
282
+ /** Port number of the endpoint. */
191
283
  port?: number;
284
+ /** Protocol scheme of the endpoint (e.g. `https`). */
192
285
  protocol?: string;
193
286
  }
194
287
  /** Details for invoking agent scope. */
195
288
  export interface InvokeAgentScopeDetails {
289
+ /** Endpoint the agent is being invoked on. */
196
290
  endpoint?: ServiceEndpoint;
197
291
  }
198
292
  /** Details of a tool call made by an agent. */
199
293
  export interface ToolCallDetails {
294
+ /** Name of the tool being called (required). */
200
295
  toolName: string;
296
+ /** Arguments passed to the tool, as an object or serialized string. */
201
297
  arguments?: Record<string, unknown> | string;
298
+ /** Unique identifier of the tool call. */
202
299
  toolCallId?: string;
300
+ /** Human-readable description of the tool. */
203
301
  description?: string;
302
+ /** Category/type of the tool (e.g. `function`). */
204
303
  toolType?: string;
304
+ /** Endpoint the tool is hosted on. */
205
305
  endpoint?: ServiceEndpoint;
206
306
  }
207
307
  /** Details for an inference call. */
208
308
  export interface InferenceDetails {
309
+ /** The inference operation type (e.g. chat, text completion). */
209
310
  operationName: InferenceOperationType;
311
+ /** Name of the model used for inference. */
210
312
  model: string;
313
+ /** Name of the provider serving the model. */
211
314
  providerName?: string;
315
+ /** Number of input (prompt) tokens. */
212
316
  inputTokens?: number;
317
+ /** Number of output (completion) tokens. */
213
318
  outputTokens?: number;
319
+ /** Finish reasons returned by the model. */
214
320
  finishReasons?: string[];
321
+ /** The model's thought process / reasoning trace. */
215
322
  thoughtProcess?: string;
323
+ /** Endpoint the model is hosted on. */
216
324
  endpoint?: ServiceEndpoint;
217
325
  }
218
326
  /** Details for recording the response from an inference call. */
219
327
  export interface InferenceResponse {
328
+ /** The response content produced by the model. */
220
329
  content: string;
330
+ /** Unique identifier of the response. */
221
331
  responseId?: string;
332
+ /** Reason the model stopped generating. */
222
333
  finishReason?: string;
334
+ /** Number of input (prompt) tokens. */
223
335
  inputTokens?: number;
336
+ /** Number of output (completion) tokens. */
224
337
  outputTokens?: number;
225
338
  }
226
339
  /** Represents a response containing output messages from an agent. */
227
340
  export interface OutputResponse {
341
+ /** The output messages produced by the agent. */
228
342
  messages: ResponseMessagesParam;
229
343
  }
230
344
  /** Parent context — either an OTel Context or a manual ParentSpanRef. */
231
345
  export type ParentContext = Context | ParentSpanRef;
232
346
  /** Manual parent span reference for cross-async-boundary tracing. */
233
347
  export interface ParentSpanRef {
348
+ /** Trace identifier of the parent span. */
234
349
  traceId: string;
350
+ /** Span identifier of the parent span. */
235
351
  spanId: string;
352
+ /** Trace flags (e.g. sampled bit) of the parent span. */
236
353
  traceFlags?: number;
354
+ /** W3C trace state carried from the parent span. */
237
355
  traceState?: TraceState;
356
+ /** Whether the parent span originated on a remote system. */
238
357
  isRemote?: boolean;
239
358
  }
240
359
  /**
241
360
  * Span configuration details for scope creation.
242
361
  */
243
362
  export interface SpanDetails {
363
+ /** Parent context the span should be created under. */
244
364
  parentContext?: ParentContext;
365
+ /** Explicit start time for the span. */
245
366
  startTime?: TimeInput;
367
+ /** Explicit end time for the span. */
246
368
  endTime?: TimeInput;
369
+ /** Kind of span to create (e.g. client, server). */
247
370
  spanKind?: SpanKind;
371
+ /** Links to other spans related to this span. */
248
372
  spanLinks?: Link[];
249
373
  }
250
374
  /**
@@ -266,10 +390,15 @@ export declare enum GuardrailDecisionType {
266
390
  * Well-known severity levels for security risks detected by guardrails.
267
391
  */
268
392
  export declare const GuardrailRiskSeverity: {
393
+ /** No risk detected. */
269
394
  readonly None: "none";
395
+ /** Low-severity risk. */
270
396
  readonly Low: "low";
397
+ /** Medium-severity risk. */
271
398
  readonly Medium: "medium";
399
+ /** High-severity risk. */
272
400
  readonly High: "high";
401
+ /** Critical-severity risk. */
273
402
  readonly Critical: "critical";
274
403
  };
275
404
  /**
@@ -277,14 +406,23 @@ export declare const GuardrailRiskSeverity: {
277
406
  * Custom strings are also accepted.
278
407
  */
279
408
  export declare const GuardrailTargetType: {
409
+ /** Input sent to an LLM. */
280
410
  readonly LlmInput: "llm_input";
411
+ /** Output produced by an LLM. */
281
412
  readonly LlmOutput: "llm_output";
413
+ /** A tool invocation. */
282
414
  readonly ToolCall: "tool_call";
415
+ /** A tool definition. */
283
416
  readonly ToolDefinition: "tool_definition";
417
+ /** A write to a memory store. */
284
418
  readonly MemoryStore: "memory_store";
419
+ /** A read from a memory store. */
285
420
  readonly MemoryRetrieve: "memory_retrieve";
421
+ /** A query against a knowledge source. */
286
422
  readonly KnowledgeQuery: "knowledge_query";
423
+ /** A result returned from a knowledge source. */
287
424
  readonly KnowledgeResult: "knowledge_result";
425
+ /** A generic message. */
288
426
  readonly Message: "message";
289
427
  };
290
428
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../../src/a365/contracts.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAMzF,2EAA2E;AAC3E,eAAO,MAAM,qBAAqB,EAAG,MAAe,CAAC;AAMrD,0EAA0E;AAC1E,oBAAY,WAAW;IACrB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,SAAS,cAAc;IACvB,IAAI,SAAS;CACd;AAED,8EAA8E;AAC9E,oBAAY,YAAY;IACtB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,cAAc,mBAAmB;IACjC,SAAS,cAAc;IACvB,KAAK,UAAU;CAChB;AAED,oDAAoD;AACpD,oBAAY,QAAQ;IAClB,KAAK,UAAU;IACf,KAAK,UAAU;IACf,KAAK,UAAU;CAChB;AAED,2DAA2D;AAC3D,oBAAY,cAAc;IACxB,KAAK,UAAU;IACf,KAAK,UAAU;IACf,KAAK,UAAU;IACf,OAAO,YAAY;CACpB;AAED,gEAAgE;AAChE,oBAAY,sBAAsB;IAChC,IAAI,SAAS;IACb,eAAe,mBAAmB;IAClC,gBAAgB,oBAAoB;CACrC;AAMD,0BAA0B;AAC1B,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,0CAA0C;AAC1C,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,CAAC;CACjD;AAED,6BAA6B;AAC7B,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,2CAA2C;AAC3C,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wCAAwC;AACxC,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,8BAA8B;AAC9B,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,KAAK,CAAC;IACZ,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,2CAA2C;AAC3C,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,4CAA4C;AAC5C,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,mCAAmC;AACnC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gBAAgB,EAAE,qBAAqB,CAAC;CACzC;AAED,iCAAiC;AACjC,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,2BAA2B,CAAC;IAClC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,yBAAyB,EAAE,6BAA6B,CAAC;CAC1D;AAED,iDAAiD;AACjD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,4EAA4E;AAC5E,MAAM,MAAM,WAAW,GACnB,QAAQ,GACR,mBAAmB,GACnB,oBAAoB,GACpB,aAAa,GACb,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,kBAAkB,GAClB,0BAA0B,GAC1B,WAAW,CAAC;AAMhB,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;IAC3B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAc,SAAQ,WAAW;IAChD,aAAa,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;CACvC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,4IAA4I;AAC5I,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,aAAa,CAAC;AAEnE,6IAA6I;AAC7I,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,cAAc,CAAC;AAErE,oDAAoD;AACpD,MAAM,MAAM,qBAAqB,GAAG,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAMlF,8CAA8C;AAC9C,MAAM,WAAW,OAAO;IACtB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,mDAAmD;AACnD,MAAM,WAAW,OAAO;IACtB,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD,iCAAiC;AACjC,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,kBAAkB,CAAC,EAAE,YAAY,CAAC;CACnC;AAMD,mDAAmD;AACnD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD,wCAAwC;AACxC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED,qCAAqC;AACrC,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,sBAAsB,CAAC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED,iEAAiE;AACjE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,qBAAqB,CAAC;CACjC;AAMD,yEAAyE;AACzE,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,aAAa,CAAC;AAEpD,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;CACpB;AAMD;;GAEG;AACH,oBAAY,qBAAqB;IAC/B,+CAA+C;IAC/C,KAAK,UAAU;IAEf,qEAAqE;IACrE,KAAK,UAAU;IAEf,2CAA2C;IAC3C,IAAI,SAAS;IAEb,mEAAmE;IACnE,MAAM,WAAW;IAEjB,uEAAuE;IACvE,IAAI,SAAS;CACd;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;CAMxB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;CAUtB,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;IAEnB,oDAAoD;IACpD,YAAY,EAAE,qBAAqB,CAAC;IAEpC,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,wEAAwE;IACxE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B,+BAA+B;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,mDAAmD;IACnD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,6BAA6B;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,0DAA0D;IAC1D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,qDAAqD;IACrD,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,wDAAwD;IACxD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC;IAErB,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAC;IAErB,0DAA0D;IAC1D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,6BAA6B;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB"}
1
+ {"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../../src/a365/contracts.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAMzF,2EAA2E;AAC3E,eAAO,MAAM,qBAAqB,EAAG,MAAe,CAAC;AAMrD,0EAA0E;AAC1E,oBAAY,WAAW;IACrB,gDAAgD;IAChD,MAAM,WAAW;IACjB,0CAA0C;IAC1C,IAAI,SAAS;IACb,iDAAiD;IACjD,SAAS,cAAc;IACvB,sDAAsD;IACtD,IAAI,SAAS;CACd;AAED,8EAA8E;AAC9E,oBAAY,YAAY;IACtB,8EAA8E;IAC9E,IAAI,SAAS;IACb,sEAAsE;IACtE,MAAM,WAAW;IACjB,kDAAkD;IAClD,cAAc,mBAAmB;IACjC,gEAAgE;IAChE,SAAS,cAAc;IACvB,8CAA8C;IAC9C,KAAK,UAAU;CAChB;AAED,oDAAoD;AACpD,oBAAY,QAAQ;IAClB,qBAAqB;IACrB,KAAK,UAAU;IACf,qBAAqB;IACrB,KAAK,UAAU;IACf,qBAAqB;IACrB,KAAK,UAAU;CAChB;AAED,2DAA2D;AAC3D,oBAAY,cAAc;IACxB,6CAA6C;IAC7C,KAAK,UAAU;IACf,8CAA8C;IAC9C,KAAK,UAAU;IACf,0DAA0D;IAC1D,KAAK,UAAU;IACf,iDAAiD;IACjD,OAAO,YAAY;CACpB;AAED,gEAAgE;AAChE,oBAAY,sBAAsB;IAChC,iCAAiC;IACjC,IAAI,SAAS;IACb,iCAAiC;IACjC,eAAe,mBAAmB;IAClC,+CAA+C;IAC/C,gBAAgB,oBAAoB;CACrC;AAMD,0BAA0B;AAC1B,MAAM,WAAW,QAAQ;IACvB,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,0CAA0C;AAC1C,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,IAAI,EAAE,WAAW,CAAC;IAClB,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,CAAC;CACjD;AAED,6BAA6B;AAC7B,MAAM,WAAW,oBAAoB;IACnC,mEAAmE;IACnE,IAAI,EAAE,oBAAoB,CAAC;IAC3B,+CAA+C;IAC/C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,IAAI,EAAE,WAAW,CAAC;IAClB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,2CAA2C;AAC3C,MAAM,WAAW,QAAQ;IACvB,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC5B,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wCAAwC;AACxC,MAAM,WAAW,QAAQ;IACvB,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC5B,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,8BAA8B;AAC9B,MAAM,WAAW,OAAO;IACtB,8DAA8D;IAC9D,IAAI,EAAE,KAAK,CAAC;IACZ,gDAAgD;IAChD,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC5B,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,2CAA2C;AAC3C,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,4CAA4C;AAC5C,MAAM,WAAW,6BAA6B;IAC5C,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,mCAAmC;AACnC,MAAM,WAAW,kBAAkB;IACjC,iEAAiE;IACjE,IAAI,EAAE,kBAAkB,CAAC;IACzB,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,oCAAoC;IACpC,gBAAgB,EAAE,qBAAqB,CAAC;CACzC;AAED,iCAAiC;AACjC,MAAM,WAAW,0BAA0B;IACzC,0EAA0E;IAC1E,IAAI,EAAE,2BAA2B,CAAC;IAClC,sDAAsD;IACtD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,6CAA6C;IAC7C,yBAAyB,EAAE,6BAA6B,CAAC;CAC1D;AAED,iDAAiD;AACjD,MAAM,WAAW,WAAW;IAC1B,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,4EAA4E;AAC5E,MAAM,MAAM,WAAW,GACnB,QAAQ,GACR,mBAAmB,GACnB,oBAAoB,GACpB,aAAa,GACb,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,kBAAkB,GAClB,0BAA0B,GAC1B,WAAW,CAAC;AAMhB,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,8DAA8D;AAC9D,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAc,SAAQ,WAAW;IAChD,8EAA8E;IAC9E,aAAa,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;CACvC;AAED,+DAA+D;AAC/D,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,4IAA4I;AAC5I,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,aAAa,CAAC;AAEnE,6IAA6I;AAC7I,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,cAAc,CAAC;AAErE,oDAAoD;AACpD,MAAM,MAAM,qBAAqB,GAAG,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAMlF,8CAA8C;AAC9C,MAAM,WAAW,OAAO;IACtB,wCAAwC;IACxC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,mDAAmD;AACnD,MAAM,WAAW,OAAO;IACtB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8DAA8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD,iCAAiC;AACjC,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC1B,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,4EAA4E;IAC5E,kBAAkB,CAAC,EAAE,YAAY,CAAC;CACnC;AAMD,mDAAmD;AACnD,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD,wCAAwC;AACxC,MAAM,WAAW,uBAAuB;IACtC,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;IAC7C,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED,qCAAqC;AACrC,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,aAAa,EAAE,sBAAsB,CAAC;IACtC,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED,iEAAiE;AACjE,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,QAAQ,EAAE,qBAAqB,CAAC;CACjC;AAMD,yEAAyE;AACzE,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,aAAa,CAAC;AAEpD,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,wCAAwC;IACxC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,sCAAsC;IACtC,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,iDAAiD;IACjD,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;CACpB;AAMD;;GAEG;AACH,oBAAY,qBAAqB;IAC/B,+CAA+C;IAC/C,KAAK,UAAU;IAEf,qEAAqE;IACrE,KAAK,UAAU;IAEf,2CAA2C;IAC3C,IAAI,SAAS;IAEb,mEAAmE;IACnE,MAAM,WAAW;IAEjB,uEAAuE;IACvE,IAAI,SAAS;CACd;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB;IAChC,wBAAwB;;IAExB,yBAAyB;;IAEzB,4BAA4B;;IAE5B,0BAA0B;;IAE1B,8BAA8B;;CAEtB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,mBAAmB;IAC9B,4BAA4B;;IAE5B,iCAAiC;;IAEjC,yBAAyB;;IAEzB,yBAAyB;;IAEzB,iCAAiC;;IAEjC,kCAAkC;;IAElC,0CAA0C;;IAE1C,iDAAiD;;IAEjD,yBAAyB;;CAEjB,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;IAEnB,oDAAoD;IACpD,YAAY,EAAE,qBAAqB,CAAC;IAEpC,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,wEAAwE;IACxE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B,+BAA+B;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,mDAAmD;IACnD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,6BAA6B;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,0DAA0D;IAC1D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,qDAAqD;IACrD,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,wDAAwD;IACxD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC;IAErB,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAC;IAErB,0DAA0D;IAC1D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,6BAA6B;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB"}
@@ -14,40 +14,59 @@ exports.DEFAULT_FINISH_REASON = "stop";
14
14
  /** Role of a message participant per OTEL gen-ai semantic conventions. */
15
15
  var MessageRole;
16
16
  (function (MessageRole) {
17
+ /** A system / developer instruction message. */
17
18
  MessageRole["SYSTEM"] = "system";
19
+ /** A message authored by the end user. */
18
20
  MessageRole["USER"] = "user";
21
+ /** A message authored by the model/assistant. */
19
22
  MessageRole["ASSISTANT"] = "assistant";
23
+ /** A message containing the result of a tool call. */
20
24
  MessageRole["TOOL"] = "tool";
21
25
  })(MessageRole || (exports.MessageRole = MessageRole = {}));
22
26
  /** Reason a model stopped generating per OTEL gen-ai semantic conventions. */
23
27
  var FinishReason;
24
28
  (function (FinishReason) {
29
+ /** The model reached a natural stopping point or a provided stop sequence. */
25
30
  FinishReason["STOP"] = "stop";
31
+ /** Generation stopped because the maximum token limit was reached. */
26
32
  FinishReason["LENGTH"] = "length";
33
+ /** Generation was stopped by a content filter. */
27
34
  FinishReason["CONTENT_FILTER"] = "content_filter";
35
+ /** The model emitted a tool call and is awaiting its result. */
28
36
  FinishReason["TOOL_CALL"] = "tool_call";
37
+ /** Generation stopped because of an error. */
29
38
  FinishReason["ERROR"] = "error";
30
39
  })(FinishReason || (exports.FinishReason = FinishReason = {}));
31
40
  /** Media modality for blob, file, and URI parts. */
32
41
  var Modality;
33
42
  (function (Modality) {
43
+ /** Image content. */
34
44
  Modality["IMAGE"] = "image";
45
+ /** Video content. */
35
46
  Modality["VIDEO"] = "video";
47
+ /** Audio content. */
36
48
  Modality["AUDIO"] = "audio";
37
49
  })(Modality || (exports.Modality = Modality = {}));
38
50
  /** Represents different roles that can invoke an agent. */
39
51
  var InvocationRole;
40
52
  (function (InvocationRole) {
53
+ /** The agent was invoked by a human user. */
41
54
  InvocationRole["Human"] = "Human";
55
+ /** The agent was invoked by another agent. */
42
56
  InvocationRole["Agent"] = "Agent";
57
+ /** The agent was invoked by a system event or trigger. */
43
58
  InvocationRole["Event"] = "Event";
59
+ /** The invoking role could not be determined. */
44
60
  InvocationRole["Unknown"] = "Unknown";
45
61
  })(InvocationRole || (exports.InvocationRole = InvocationRole = {}));
46
62
  /** Represents different operation types for model inference. */
47
63
  var InferenceOperationType;
48
64
  (function (InferenceOperationType) {
65
+ /** A chat-completion request. */
49
66
  InferenceOperationType["CHAT"] = "Chat";
67
+ /** A text-completion request. */
50
68
  InferenceOperationType["TEXT_COMPLETION"] = "TextCompletion";
69
+ /** A multimodal content-generation request. */
51
70
  InferenceOperationType["GENERATE_CONTENT"] = "GenerateContent";
52
71
  })(InferenceOperationType || (exports.InferenceOperationType = InferenceOperationType = {}));
53
72
  // ---------------------------------------------------------------------------
@@ -73,10 +92,15 @@ var GuardrailDecisionType;
73
92
  * Well-known severity levels for security risks detected by guardrails.
74
93
  */
75
94
  exports.GuardrailRiskSeverity = {
95
+ /** No risk detected. */
76
96
  None: "none",
97
+ /** Low-severity risk. */
77
98
  Low: "low",
99
+ /** Medium-severity risk. */
78
100
  Medium: "medium",
101
+ /** High-severity risk. */
79
102
  High: "high",
103
+ /** Critical-severity risk. */
80
104
  Critical: "critical",
81
105
  };
82
106
  /**
@@ -84,14 +108,23 @@ exports.GuardrailRiskSeverity = {
84
108
  * Custom strings are also accepted.
85
109
  */
86
110
  exports.GuardrailTargetType = {
111
+ /** Input sent to an LLM. */
87
112
  LlmInput: "llm_input",
113
+ /** Output produced by an LLM. */
88
114
  LlmOutput: "llm_output",
115
+ /** A tool invocation. */
89
116
  ToolCall: "tool_call",
117
+ /** A tool definition. */
90
118
  ToolDefinition: "tool_definition",
119
+ /** A write to a memory store. */
91
120
  MemoryStore: "memory_store",
121
+ /** A read from a memory store. */
92
122
  MemoryRetrieve: "memory_retrieve",
123
+ /** A query against a knowledge source. */
93
124
  KnowledgeQuery: "knowledge_query",
125
+ /** A result returned from a knowledge source. */
94
126
  KnowledgeResult: "knowledge_result",
127
+ /** A generic message. */
95
128
  Message: "message",
96
129
  };
97
130
  //# sourceMappingURL=contracts.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/a365/contracts.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;;AAWlC,8EAA8E;AAC9E,wCAAwC;AACxC,8EAA8E;AAE9E,2EAA2E;AAC9D,QAAA,qBAAqB,GAAG,MAAe,CAAC;AAErD,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E,0EAA0E;AAC1E,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,gCAAiB,CAAA;IACjB,4BAAa,CAAA;IACb,sCAAuB,CAAA;IACvB,4BAAa,CAAA;AACf,CAAC,EALW,WAAW,2BAAX,WAAW,QAKtB;AAED,8EAA8E;AAC9E,IAAY,YAMX;AAND,WAAY,YAAY;IACtB,6BAAa,CAAA;IACb,iCAAiB,CAAA;IACjB,iDAAiC,CAAA;IACjC,uCAAuB,CAAA;IACvB,+BAAe,CAAA;AACjB,CAAC,EANW,YAAY,4BAAZ,YAAY,QAMvB;AAED,oDAAoD;AACpD,IAAY,QAIX;AAJD,WAAY,QAAQ;IAClB,2BAAe,CAAA;IACf,2BAAe,CAAA;IACf,2BAAe,CAAA;AACjB,CAAC,EAJW,QAAQ,wBAAR,QAAQ,QAInB;AAED,2DAA2D;AAC3D,IAAY,cAKX;AALD,WAAY,cAAc;IACxB,iCAAe,CAAA;IACf,iCAAe,CAAA;IACf,iCAAe,CAAA;IACf,qCAAmB,CAAA;AACrB,CAAC,EALW,cAAc,8BAAd,cAAc,QAKzB;AAED,gEAAgE;AAChE,IAAY,sBAIX;AAJD,WAAY,sBAAsB;IAChC,uCAAa,CAAA;IACb,4DAAkC,CAAA;IAClC,8DAAoC,CAAA;AACtC,CAAC,EAJW,sBAAsB,sCAAtB,sBAAsB,QAIjC;AAwRD,8EAA8E;AAC9E,iCAAiC;AACjC,8EAA8E;AAE9E;;GAEG;AACH,IAAY,qBAeX;AAfD,WAAY,qBAAqB;IAC/B,+CAA+C;IAC/C,wCAAe,CAAA;IAEf,qEAAqE;IACrE,wCAAe,CAAA;IAEf,2CAA2C;IAC3C,sCAAa,CAAA;IAEb,mEAAmE;IACnE,0CAAiB,CAAA;IAEjB,uEAAuE;IACvE,sCAAa,CAAA;AACf,CAAC,EAfW,qBAAqB,qCAArB,qBAAqB,QAehC;AAED;;GAEG;AACU,QAAA,qBAAqB,GAAG;IACnC,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,UAAU;CACZ,CAAC;AAEX;;;GAGG;AACU,QAAA,mBAAmB,GAAG;IACjC,QAAQ,EAAE,WAAW;IACrB,SAAS,EAAE,YAAY;IACvB,QAAQ,EAAE,WAAW;IACrB,cAAc,EAAE,iBAAiB;IACjC,WAAW,EAAE,cAAc;IAC3B,cAAc,EAAE,iBAAiB;IACjC,cAAc,EAAE,iBAAiB;IACjC,eAAe,EAAE,kBAAkB;IACnC,OAAO,EAAE,SAAS;CACV,CAAC"}
1
+ {"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/a365/contracts.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;;AAWlC,8EAA8E;AAC9E,wCAAwC;AACxC,8EAA8E;AAE9E,2EAA2E;AAC9D,QAAA,qBAAqB,GAAG,MAAe,CAAC;AAErD,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E,0EAA0E;AAC1E,IAAY,WASX;AATD,WAAY,WAAW;IACrB,gDAAgD;IAChD,gCAAiB,CAAA;IACjB,0CAA0C;IAC1C,4BAAa,CAAA;IACb,iDAAiD;IACjD,sCAAuB,CAAA;IACvB,sDAAsD;IACtD,4BAAa,CAAA;AACf,CAAC,EATW,WAAW,2BAAX,WAAW,QAStB;AAED,8EAA8E;AAC9E,IAAY,YAWX;AAXD,WAAY,YAAY;IACtB,8EAA8E;IAC9E,6BAAa,CAAA;IACb,sEAAsE;IACtE,iCAAiB,CAAA;IACjB,kDAAkD;IAClD,iDAAiC,CAAA;IACjC,gEAAgE;IAChE,uCAAuB,CAAA;IACvB,8CAA8C;IAC9C,+BAAe,CAAA;AACjB,CAAC,EAXW,YAAY,4BAAZ,YAAY,QAWvB;AAED,oDAAoD;AACpD,IAAY,QAOX;AAPD,WAAY,QAAQ;IAClB,qBAAqB;IACrB,2BAAe,CAAA;IACf,qBAAqB;IACrB,2BAAe,CAAA;IACf,qBAAqB;IACrB,2BAAe,CAAA;AACjB,CAAC,EAPW,QAAQ,wBAAR,QAAQ,QAOnB;AAED,2DAA2D;AAC3D,IAAY,cASX;AATD,WAAY,cAAc;IACxB,6CAA6C;IAC7C,iCAAe,CAAA;IACf,8CAA8C;IAC9C,iCAAe,CAAA;IACf,0DAA0D;IAC1D,iCAAe,CAAA;IACf,iDAAiD;IACjD,qCAAmB,CAAA;AACrB,CAAC,EATW,cAAc,8BAAd,cAAc,QASzB;AAED,gEAAgE;AAChE,IAAY,sBAOX;AAPD,WAAY,sBAAsB;IAChC,iCAAiC;IACjC,uCAAa,CAAA;IACb,iCAAiC;IACjC,4DAAkC,CAAA;IAClC,+CAA+C;IAC/C,8DAAoC,CAAA;AACtC,CAAC,EAPW,sBAAsB,sCAAtB,sBAAsB,QAOjC;AAiYD,8EAA8E;AAC9E,iCAAiC;AACjC,8EAA8E;AAE9E;;GAEG;AACH,IAAY,qBAeX;AAfD,WAAY,qBAAqB;IAC/B,+CAA+C;IAC/C,wCAAe,CAAA;IAEf,qEAAqE;IACrE,wCAAe,CAAA;IAEf,2CAA2C;IAC3C,sCAAa,CAAA;IAEb,mEAAmE;IACnE,0CAAiB,CAAA;IAEjB,uEAAuE;IACvE,sCAAa,CAAA;AACf,CAAC,EAfW,qBAAqB,qCAArB,qBAAqB,QAehC;AAED;;GAEG;AACU,QAAA,qBAAqB,GAAG;IACnC,wBAAwB;IACxB,IAAI,EAAE,MAAM;IACZ,yBAAyB;IACzB,GAAG,EAAE,KAAK;IACV,4BAA4B;IAC5B,MAAM,EAAE,QAAQ;IAChB,0BAA0B;IAC1B,IAAI,EAAE,MAAM;IACZ,8BAA8B;IAC9B,QAAQ,EAAE,UAAU;CACZ,CAAC;AAEX;;;GAGG;AACU,QAAA,mBAAmB,GAAG;IACjC,4BAA4B;IAC5B,QAAQ,EAAE,WAAW;IACrB,iCAAiC;IACjC,SAAS,EAAE,YAAY;IACvB,yBAAyB;IACzB,QAAQ,EAAE,WAAW;IACrB,yBAAyB;IACzB,cAAc,EAAE,iBAAiB;IACjC,iCAAiC;IACjC,WAAW,EAAE,cAAc;IAC3B,kCAAkC;IAClC,cAAc,EAAE,iBAAiB;IACjC,0CAA0C;IAC1C,cAAc,EAAE,iBAAiB;IACjC,iDAAiD;IACjD,eAAe,EAAE,kBAAkB;IACnC,yBAAyB;IACzB,OAAO,EAAE,SAAS;CACV,CAAC"}
@@ -1,5 +1,5 @@
1
1
  import type { ExportResult } from "@opentelemetry/core";
2
- import type { ReadableSpan, SpanExporter } from "@opentelemetry/sdk-trace-base";
2
+ import type { BufferConfig, ReadableSpan, SpanExporter } from "@opentelemetry/sdk-trace-base";
3
3
  import type { Agent365ExporterOptions } from "./Agent365ExporterOptions.js";
4
4
  /**
5
5
  * Agent365 span exporter.
@@ -12,7 +12,31 @@ export declare class Agent365Exporter implements SpanExporter {
12
12
  private closed;
13
13
  private readonly options;
14
14
  private get logger();
15
+ /**
16
+ * Creates a new Agent365 span exporter.
17
+ *
18
+ * @param options Optional exporter configuration (token resolution, endpoint
19
+ * overrides, batching, and payload limits). When omitted, defaults are applied.
20
+ */
15
21
  constructor(options?: Agent365ExporterOptions);
22
+ /**
23
+ * Returns the {@link BufferConfig} the host should pass to its
24
+ * `BatchSpanProcessor`. Any value the caller supplied wins; anything
25
+ * omitted falls back to the A365 exporter's documented defaults
26
+ * (not the upstream `BatchSpanProcessor` defaults).
27
+ */
28
+ getBufferConfig(): BufferConfig;
29
+ /**
30
+ * Exports a batch of spans to the Agent365 observability service.
31
+ *
32
+ * Partitions the spans by (tenantId, agentId), builds OTLP-like JSON payloads,
33
+ * and POSTs them with bearer authentication. Invokes `resultCallback` with
34
+ * `ExportResultCode.SUCCESS` when all groups export successfully, or
35
+ * `ExportResultCode.FAILED` when the exporter is shut down or any group fails.
36
+ *
37
+ * @param spans The spans to export.
38
+ * @param resultCallback Callback invoked with the export result.
39
+ */
16
40
  export(spans: ReadableSpan[], resultCallback: (result: ExportResult) => void): Promise<void>;
17
41
  private exportGroup;
18
42
  private resolveToken;
@@ -21,7 +45,15 @@ export declare class Agent365Exporter implements SpanExporter {
21
45
  private getResourceAttributes;
22
46
  private buildEnvelope;
23
47
  private mapSpan;
48
+ /**
49
+ * Shuts down the exporter. After this resolves, subsequent {@link export}
50
+ * calls fail immediately. Any in-flight exports are not awaited.
51
+ */
24
52
  shutdown(): Promise<void>;
53
+ /**
54
+ * Flushes any pending spans. This is a no-op because spans are exported
55
+ * immediately on each {@link export} call rather than being buffered.
56
+ */
25
57
  forceFlush(): Promise<void>;
26
58
  private logExporterEvent;
27
59
  }
@@ -1 +1 @@
1
- {"version":3,"file":"Agent365Exporter.d.ts","sourceRoot":"","sources":["../../../../src/a365/exporter/Agent365Exporter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAEhF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AA8E5E;;;;;;GAMG;AACH,qBAAa,gBAAiB,YAAW,YAAY;IACnD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAElD,OAAO,KAAK,MAAM,GAEjB;gBAEW,OAAO,CAAC,EAAE,uBAAuB;IAIvC,MAAM,CACV,KAAK,EAAE,YAAY,EAAE,EACrB,cAAc,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,GAC7C,OAAO,CAAC,IAAI,CAAC;YAuDF,WAAW;YAmFX,YAAY;YAuBZ,eAAe;IA2E7B,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,qBAAqB;IAO7B,OAAO,CAAC,aAAa;IAoCrB,OAAO,CAAC,OAAO;IAwDT,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,OAAO,CAAC,gBAAgB;CAoBzB"}
1
+ {"version":3,"file":"Agent365Exporter.d.ts","sourceRoot":"","sources":["../../../../src/a365/exporter/Agent365Exporter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE9F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AA8F5E;;;;;;GAMG;AACH,qBAAa,gBAAiB,YAAW,YAAY;IACnD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAElD,OAAO,KAAK,MAAM,GAEjB;IAED;;;;;OAKG;gBACS,OAAO,CAAC,EAAE,uBAAuB;IAI7C;;;;;OAKG;IACH,eAAe,IAAI,YAAY;IAS/B;;;;;;;;;;OAUG;IACG,MAAM,CACV,KAAK,EAAE,YAAY,EAAE,EACrB,cAAc,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,GAC7C,OAAO,CAAC,IAAI,CAAC;YAuDF,WAAW;YAmFX,YAAY;YAuBZ,eAAe;IAkG7B,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,qBAAqB;IAO7B,OAAO,CAAC,aAAa;IAoCrB,OAAO,CAAC,OAAO;IAwDf;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,OAAO,CAAC,gBAAgB;CAoBzB"}