@databricks/sdk-genie 0.49.0 → 0.54.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.
package/dist/package.js CHANGED
@@ -1,6 +1,6 @@
1
1
  //#region package.json
2
2
  var name = "@databricks/sdk-genie";
3
- var version = "0.49.0";
3
+ var version = "0.54.0";
4
4
 
5
5
  //#endregion
6
6
  export { name, version };
@@ -1,4 +1,4 @@
1
- import { DownloadMessageAttachmentVisualizationRequest, DownloadMessageAttachmentVisualizationResponse, GenieCreateConversationMessageRequest, GenieCreateEvalRunRequest, GenieCreateMessageCommentRequest, GenieCreateSpaceRequest, GenieDeleteConversationMessageRequest, GenieDeleteConversationRequest, GenieEvalResultDetails, GenieEvalRunResponse, GenieExecuteMessageAttachmentQueryRequest, GenieExecuteMessageQueryRequest, GenieGenerateDownloadFullQueryResultRequest, GenieGenerateDownloadFullQueryResultResponse, GenieGetConversationMessageRequest, GenieGetDownloadFullQueryResultRequest, GenieGetDownloadFullQueryResultResponse, GenieGetEvalResultDetailsRequest, GenieGetEvalRunRequest, GenieGetMessageAttachmentQueryResultRequest, GenieGetMessageQueryResultRequest, GenieGetMessageQueryResultResponse, GenieGetQueryResultByAttachmentRequest, GenieGetSpaceRequest, GenieListConversationCommentsRequest, GenieListConversationCommentsResponse, GenieListConversationMessagesRequest, GenieListConversationMessagesResponse, GenieListConversationsRequest, GenieListConversationsResponse, GenieListEvalResultsRequest, GenieListEvalResultsResponse, GenieListEvalRunsRequest, GenieListEvalRunsResponse, GenieListMessageCommentsRequest, GenieListMessageCommentsResponse, GenieListSpacesRequest, GenieListSpacesResponse, GenieMessage, GenieMessageComment, GenieSendMessageFeedbackRequest, GenieSpace, GenieStartConversationRequest, GenieTrashSpaceRequest, GenieUpdateSpaceRequest } from "./model.js";
1
+ import { DownloadMessageAttachmentVisualizationRequest, DownloadMessageAttachmentVisualizationResponse, GenieCancelResponseRequest, GenieCreateConversationMessageRequest, GenieCreateEvalRunRequest, GenieCreateMessageCommentRequest, GenieCreateSpaceRequest, GenieDeleteConversationMessageRequest, GenieDeleteConversationRequest, GenieEvalResultDetails, GenieEvalRunResponse, GenieExecuteMessageAttachmentQueryRequest, GenieExecuteMessageQueryRequest, GenieGenerateDownloadFullQueryResultRequest, GenieGenerateDownloadFullQueryResultResponse, GenieGetConversationMessageRequest, GenieGetDownloadFullQueryResultRequest, GenieGetDownloadFullQueryResultResponse, GenieGetEvalResultDetailsRequest, GenieGetEvalRunRequest, GenieGetMessageAttachmentQueryResultRequest, GenieGetMessageQueryResultRequest, GenieGetMessageQueryResultResponse, GenieGetQueryResultByAttachmentRequest, GenieGetSpaceRequest, GenieListConversationCommentsRequest, GenieListConversationCommentsResponse, GenieListConversationMessagesRequest, GenieListConversationMessagesResponse, GenieListConversationsRequest, GenieListConversationsResponse, GenieListEvalResultsRequest, GenieListEvalResultsResponse, GenieListEvalRunsRequest, GenieListEvalRunsResponse, GenieListMessageCommentsRequest, GenieListMessageCommentsResponse, GenieListSpacesRequest, GenieListSpacesResponse, GenieMessage, GenieMessageComment, GenieSendMessageFeedbackRequest, GenieSpace, GenieStartConversationRequest, GenieTrashSpaceRequest, GenieUpdateSpaceRequest } from "./model.js";
2
2
  import { CallOptions } from "@databricks/sdk-options/call";
3
3
  import { ClientOptions } from "@databricks/sdk-options/client";
4
4
  import { LroOptions } from "@databricks/sdk-options/lro";
@@ -17,20 +17,25 @@ declare class GenieClient {
17
17
  * Download a rendered image of a message visualization attachment.
18
18
  * The response body is the raw PNG image, not a JSON payload.
19
19
  * This is only available if the attachment is a visualization and the message status is `COMPLETED`.
20
- * This endpoint is not supported for Private Link workspaces.
21
20
  */
22
21
  downloadMessageAttachmentVisualization(req: DownloadMessageAttachmentVisualizationRequest, options?: CallOptions): Promise<DownloadMessageAttachmentVisualizationResponse>;
23
22
  /**
24
- * Create new message in a [conversation](:method:genie/startconversation).
23
+ * Cancels an in-flight agent-mode response. `response_id` is the id returned in the
24
+ * `response.created` event from the agent-mode responses endpoint. The response stops at
25
+ * the next agent boundary and its terminal state is returned.
26
+ */
27
+ genieCancelResponse(req: GenieCancelResponseRequest, options?: CallOptions): Promise<GenieMessage>;
28
+ /**
29
+ * Sends a new message in a chat-mode [conversation](:method:genie/startconversation).
25
30
  * The AI response uses all previously created messages in the conversation to respond.
26
31
  */
27
32
  private genieCreateConversationMessageBase;
28
33
  /**
29
- * Create new message in a [conversation](:method:genie/startconversation).
34
+ * Sends a new message in a chat-mode [conversation](:method:genie/startconversation).
30
35
  * The AI response uses all previously created messages in the conversation to respond.
31
36
  */
32
37
  genieCreateConversationMessage(req: GenieCreateConversationMessageRequest, options?: CallOptions): Promise<GenieCreateConversationMessageWaiter>;
33
- /** Create and run evaluations for multiple benchmark questions in a Genie space. */
38
+ /** Creates and runs chat-mode evaluations for multiple benchmark questions in a Genie space. */
34
39
  genieCreateEvalRun(req: GenieCreateEvalRunRequest, options?: CallOptions): Promise<GenieEvalRunResponse>;
35
40
  /** Create a comment on a conversation message. */
36
41
  genieCreateMessageComment(req: GenieCreateMessageCommentRequest, options?: CallOptions): Promise<GenieMessageComment>;
@@ -51,24 +56,23 @@ declare class GenieClient {
51
56
  *
52
57
  * ### **Warning: Databricks strongly recommends that you protect the URLs that are returned by the `EXTERNAL_LINKS` disposition.**
53
58
  *
54
- * When you use the `EXTERNAL_LINKS` disposition, a
55
- * short-lived, URL is generated, which can be
56
- * used to download the results directly
57
- * from . As a
58
- * short-lived is
59
- * embedded in this URL, you should protect
60
- * the URL.
59
+ * When you use the `EXTERNAL_LINKS` disposition, a short-lived cloud-storage URL is generated to download the
60
+ * results. The URL contains temporary access credentials, so protect it and do not set an `Authorization` header in
61
+ * the download request.
62
+ *
63
+ *
64
+ *
61
65
  *
62
- * Because URLs are already generated with
63
- * embedded temporary s,
64
- * you must not set an `Authorization` header in the download requests.
65
66
  *
66
67
  * See [Execute Statement](:method:statementexecution/executestatement) for more details.
67
68
  *
68
69
  * ----
69
70
  */
70
71
  genieGenerateDownloadFullQueryResult(req: GenieGenerateDownloadFullQueryResultRequest, options?: CallOptions): Promise<GenieGenerateDownloadFullQueryResultResponse>;
71
- /** Get message from conversation. */
72
+ /**
73
+ * Gets a message from a chat-mode or agent-mode conversation.
74
+ * For a complete agent-mode transcript, use the List conversation items endpoint.
75
+ */
72
76
  genieGetConversationMessage(req: GenieGetConversationMessageRequest, options?: CallOptions): Promise<GenieMessage>;
73
77
  /**
74
78
  * After [Generating a Full Query Result Download](:method:genie/generatedownloadfullqueryresult) and successfully receiving a `download_id` and `download_id_signature`, use this API to poll the download progress.
@@ -79,17 +83,13 @@ declare class GenieClient {
79
83
  *
80
84
  * ### **Warning: Databricks strongly recommends that you protect the URLs that are returned by the `EXTERNAL_LINKS` disposition.**
81
85
  *
82
- * When you use the `EXTERNAL_LINKS` disposition, a
83
- * short-lived, URL is generated, which can be
84
- * used to download the results directly
85
- * from . As a
86
- * short-lived is
87
- * embedded in this URL, you should protect
88
- * the URL.
86
+ * When you use the `EXTERNAL_LINKS` disposition, a short-lived cloud-storage URL is generated to download the
87
+ * results. The URL contains temporary access credentials, so protect it and do not set an `Authorization` header in
88
+ * the download request.
89
+ *
90
+ *
91
+ *
89
92
  *
90
- * Because URLs are already generated with
91
- * embedded temporary s,
92
- * you must not set an `Authorization` header in the download requests.
93
93
  *
94
94
  * See [Execute Statement](:method:statementexecution/executestatement) for more details.
95
95
  *
@@ -113,7 +113,11 @@ declare class GenieClient {
113
113
  genieGetSpace(req: GenieGetSpaceRequest, options?: CallOptions): Promise<GenieSpace>;
114
114
  /** List all comments across all messages in a conversation. */
115
115
  genieListConversationComments(req: GenieListConversationCommentsRequest, options?: CallOptions): Promise<GenieListConversationCommentsResponse>;
116
- /** List messages in a conversation */
116
+ /**
117
+ * Lists messages in a chat-mode or agent-mode conversation.
118
+ * Agent-mode messages are returned as GenieMessage projections. Use the List conversation items
119
+ * endpoint for the complete reasoning and tool-call history.
120
+ */
117
121
  genieListConversationMessages(req: GenieListConversationMessagesRequest, options?: CallOptions): Promise<GenieListConversationMessagesResponse>;
118
122
  /** Get a list of conversations in a Genie Space. */
119
123
  genieListConversations(req: GenieListConversationsRequest, options?: CallOptions): Promise<GenieListConversationsResponse>;
@@ -125,11 +129,11 @@ declare class GenieClient {
125
129
  genieListMessageComments(req: GenieListMessageCommentsRequest, options?: CallOptions): Promise<GenieListMessageCommentsResponse>;
126
130
  /** Get list of Genie Spaces. */
127
131
  genieListSpaces(req: GenieListSpacesRequest, options?: CallOptions): Promise<GenieListSpacesResponse>;
128
- /** Send feedback for a message. */
132
+ /** Sends feedback for a message in a chat-mode or agent-mode conversation. */
129
133
  genieSendMessageFeedback(req: GenieSendMessageFeedbackRequest, options?: CallOptions): Promise<void>;
130
- /** Start a new conversation. */
134
+ /** Starts a new chat-mode conversation and sends its first message. */
131
135
  private genieStartConversationBase;
132
- /** Start a new conversation. */
136
+ /** Starts a new chat-mode conversation and sends its first message. */
133
137
  genieStartConversation(req: GenieStartConversationRequest, options?: CallOptions): Promise<GenieStartConversationWaiter>;
134
138
  /** Move a Genie Space to the trash. */
135
139
  genieTrashSpace(req: GenieTrashSpaceRequest, options?: CallOptions): Promise<void>;
@@ -1 +1 @@
1
- {"version":3,"file":"client.d.ts","names":[],"sources":["../../src/v1/client.ts"],"mappings":"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"}
1
+ {"version":3,"file":"client.d.ts","names":[],"sources":["../../src/v1/client.ts"],"mappings":";;;;;;cA4Ga,WAAA;EAAA,iBACM,OAAA;EAAA,iBACA,MAAA;EAAA,iBAIA,SAAA;EAAA,QAIT,MAAA;cAEI,OAAA,EAAS,aAAA;EAAA,QAUb,aAAA;EAQI;EAFN,WAAA,CACJ,GAAA,EAAK,uBAAA,EACL,OAAA,GAAU,WAAA,GACT,OAAA,CAAQ,UAAA;EAAR;;;;;EA+BG,sCAAA,CACJ,GAAA,EAAK,6CAAA,EACL,OAAA,GAAU,WAAA,GACT,OAAA,CAAQ,8CAAA;EAkCC;;;;;EAFN,mBAAA,CACJ,GAAA,EAAK,0BAAA,EACL,OAAA,GAAU,WAAA,GACT,OAAA,CAAQ,YAAA;EAqER;;;;EAAA,QAvCW,kCAAA;EA8FP;;;;EA1DD,8BAAA,CACJ,GAAA,EAAK,qCAAA,EACL,OAAA,GAAU,WAAA,GACT,OAAA,CAAQ,oCAAA;EAyFC;EAjEN,kBAAA,CACJ,GAAA,EAAK,yBAAA,EACL,OAAA,GAAU,WAAA,GACT,OAAA,CAAQ,oBAAA;EAoFJ;EAzDD,yBAAA,CACJ,GAAA,EAAK,gCAAA,EACL,OAAA,GAAU,WAAA,GACT,OAAA,CAAQ,mBAAA;EAwDR;EA1BG,uBAAA,CACJ,GAAA,EAAK,8BAAA,EACL,OAAA,GAAU,WAAA,GACT,OAAA;EA6CS;EAzBN,8BAAA,CACJ,GAAA,EAAK,qCAAA,EACL,OAAA,GAAU,WAAA,GACT,OAAA;EAuBA;EAHG,kCAAA,CACJ,GAAA,EAAK,yCAAA,EACL,OAAA,GAAU,WAAA,GACT,OAAA,CAAQ,kCAAA;EAmCC;EAFN,wBAAA,CACJ,GAAA,EAAK,+BAAA,EACL,OAAA,GAAU,WAAA,GACT,OAAA,CAAQ,kCAAA;EAAR;;;;;;;;;;;;;;;;;;;;;EAqDG,oCAAA,CACJ,GAAA,EAAK,2CAAA,EACL,OAAA,GAAU,WAAA,GACT,OAAA,CAAQ,4CAAA;EA0LC;;;;EAtJN,2BAAA,CACJ,GAAA,EAAK,kCAAA,EACL,OAAA,GAAU,WAAA,GACT,OAAA,CAAQ,YAAA;EAoLA;;;;;;;;;;;;;;;;;;;;;EAtIL,+BAAA,CACJ,GAAA,EAAK,sCAAA,EACL,OAAA,GAAU,WAAA,GACT,OAAA,CAAQ,uCAAA;EAyWJ;EAtUD,yBAAA,CACJ,GAAA,EAAK,gCAAA,EACL,OAAA,GAAU,WAAA,GACT,OAAA,CAAQ,sBAAA;EAqUA;EA3SL,eAAA,CACJ,GAAA,EAAK,sBAAA,EACL,OAAA,GAAU,WAAA,GACT,OAAA,CAAQ,oBAAA;EA+UJ;;;;EAlTD,oCAAA,CACJ,GAAA,EAAK,2CAAA,EACL,OAAA,GAAU,WAAA,GACT,OAAA,CAAQ,kCAAA;EAsVC;EAzTN,0BAAA,CACJ,GAAA,EAAK,iCAAA,EACL,OAAA,GAAU,WAAA,GACT,OAAA,CAAQ,kCAAA;EAuTR;EA1RG,+BAAA,CACJ,GAAA,EAAK,sCAAA,EACL,OAAA,GAAU,WAAA,GACT,OAAA,CAAQ,kCAAA;EA+TC;EAlSN,aAAA,CACJ,GAAA,EAAK,oBAAA,EACL,OAAA,GAAU,WAAA,GACT,OAAA,CAAQ,UAAA;EAgSR;EA7PG,6BAAA,CACJ,GAAA,EAAK,oCAAA,EACL,OAAA,GAAU,WAAA,GACT,OAAA,CAAQ,qCAAA;EA+RC;;;;;EArPN,6BAAA,CACJ,GAAA,EAAK,oCAAA,EACL,OAAA,GAAU,WAAA,GACT,OAAA,CAAQ,qCAAA;EA2UJ;EArSD,sBAAA,CACJ,GAAA,EAAK,6BAAA,EACL,OAAA,GAAU,WAAA,GACT,OAAA,CAAQ,8BAAA;EAoSR;EA3PG,oBAAA,CACJ,GAAA,EAAK,2BAAA,EACL,OAAA,GAAU,WAAA,GACT,OAAA,CAAQ,4BAAA;EA8QC;EAxON,iBAAA,CACJ,GAAA,EAAK,wBAAA,EACL,OAAA,GAAU,WAAA,GACT,OAAA,CAAQ,yBAAA;EAsOR;EAnMG,wBAAA,CACJ,GAAA,EAAK,+BAAA,EACL,OAAA,GAAU,WAAA,GACT,OAAA,CAAQ,gCAAA;EAgMD;EA1JJ,eAAA,CACJ,GAAA,EAAK,sBAAA,EACL,OAAA,GAAU,WAAA,GACT,OAAA,CAAQ,uBAAA;EAt8BM;EAy+BX,wBAAA,CACJ,GAAA,EAAK,+BAAA,EACL,OAAA,GAAU,WAAA,GACT,OAAA;EAp+BK;EAAA,QA4/BM,0BAAA;EA1/BO;EA8hCf,sBAAA,CACJ,GAAA,EAAK,6BAAA,EACL,OAAA,GAAU,WAAA,GACT,OAAA,CAAQ,4BAAA;EAvhCH;EA+iCF,eAAA,CACJ,GAAA,EAAK,sBAAA,EACL,OAAA,GAAU,WAAA,GACT,OAAA;EA3iCI;EA+jCD,WAAA,CACJ,GAAA,EAAK,uBAAA,EACL,OAAA,GAAU,WAAA,GACT,OAAA,CAAQ,UAAA;AAAA;AAAA,cA2BA,oCAAA;EAAA,iBAEQ,MAAA;EAAA,SACR,SAAA;EAAA,SACA,cAAA;EAAA,SACA,OAAA;cAHQ,MAAA,EAAQ,WAAA,EAChB,SAAA,UACA,cAAA,UACA,OAAA;EA/jCC;;;;;EAukCN,IAAA,CAAK,OAAA,GAAU,UAAA,GAAa,OAAA,CAAQ,YAAA;EAriCxC;EA4kCI,IAAA,CAAK,OAAA,GAAU,WAAA,GAAc,OAAA;AAAA;AAAA,cAyBxB,4BAAA;EAAA,iBAEQ,MAAA;EAAA,SACR,SAAA;EAAA,SACA,cAAA;EAAA,SACA,OAAA;cAHQ,MAAA,EAAQ,WAAA,EAChB,SAAA,UACA,cAAA,UACA,OAAA;EApiCC;;;;;EA4iCN,IAAA,CAAK,OAAA,GAAU,UAAA,GAAa,OAAA,CAAQ,YAAA;EAlhCxC;EAyjCI,IAAA,CAAK,OAAA,GAAU,WAAA,GAAc,OAAA;AAAA"}
package/dist/v1/client.js CHANGED
@@ -1,7 +1,7 @@
1
1
  import { resolveClientConfig } from "./transport.js";
2
2
  import { StillRunningError, buildHttpRequest, executeCall, executeHttpCall, executeWait, marshalRequest, parseResponse, sendAndCheckError } from "./utils.js";
3
3
  import { name, version } from "../package.js";
4
- import { MessageStatus_MessageStatus, marshalGenieCreateConversationMessageRequestSchema, marshalGenieCreateEvalRunRequestSchema, marshalGenieCreateMessageCommentRequestSchema, marshalGenieCreateSpaceRequestSchema, marshalGenieExecuteMessageAttachmentQueryRequestSchema, marshalGenieExecuteMessageQueryRequestSchema, marshalGenieGenerateDownloadFullQueryResultRequestSchema, marshalGenieSendMessageFeedbackRequestSchema, marshalGenieStartConversationRequestSchema, marshalGenieUpdateSpaceRequestSchema, unmarshalGenieEvalResultDetailsSchema, unmarshalGenieEvalRunResponseSchema, unmarshalGenieGenerateDownloadFullQueryResultResponseSchema, unmarshalGenieGetDownloadFullQueryResultResponseSchema, unmarshalGenieGetMessageQueryResultResponseSchema, unmarshalGenieListConversationCommentsResponseSchema, unmarshalGenieListConversationMessagesResponseSchema, unmarshalGenieListConversationsResponseSchema, unmarshalGenieListEvalResultsResponseSchema, unmarshalGenieListEvalRunsResponseSchema, unmarshalGenieListMessageCommentsResponseSchema, unmarshalGenieListSpacesResponseSchema, unmarshalGenieMessageCommentSchema, unmarshalGenieMessageSchema, unmarshalGenieSpaceSchema, unmarshalGenieStartConversationResponseSchema } from "./model.js";
4
+ import { MessageStatus_MessageStatus, marshalGenieCancelResponseRequestSchema, marshalGenieCreateConversationMessageRequestSchema, marshalGenieCreateEvalRunRequestSchema, marshalGenieCreateMessageCommentRequestSchema, marshalGenieCreateSpaceRequestSchema, marshalGenieExecuteMessageAttachmentQueryRequestSchema, marshalGenieExecuteMessageQueryRequestSchema, marshalGenieGenerateDownloadFullQueryResultRequestSchema, marshalGenieSendMessageFeedbackRequestSchema, marshalGenieStartConversationRequestSchema, marshalGenieUpdateSpaceRequestSchema, unmarshalGenieEvalResultDetailsSchema, unmarshalGenieEvalRunResponseSchema, unmarshalGenieGenerateDownloadFullQueryResultResponseSchema, unmarshalGenieGetDownloadFullQueryResultResponseSchema, unmarshalGenieGetMessageQueryResultResponseSchema, unmarshalGenieListConversationCommentsResponseSchema, unmarshalGenieListConversationMessagesResponseSchema, unmarshalGenieListConversationsResponseSchema, unmarshalGenieListEvalResultsResponseSchema, unmarshalGenieListEvalRunsResponseSchema, unmarshalGenieListMessageCommentsResponseSchema, unmarshalGenieListSpacesResponseSchema, unmarshalGenieMessageCommentSchema, unmarshalGenieMessageSchema, unmarshalGenieSpaceSchema, unmarshalGenieStartConversationResponseSchema } from "./model.js";
5
5
  import { VERSION } from "@databricks/sdk-auth";
6
6
  import { createDefault } from "@databricks/sdk-core/clientinfo";
7
7
  import { NoOpLogger } from "@databricks/sdk-core/logger";
@@ -55,14 +55,13 @@ var GenieClient = class {
55
55
  * Download a rendered image of a message visualization attachment.
56
56
  * The response body is the raw PNG image, not a JSON payload.
57
57
  * This is only available if the attachment is a visualization and the message status is `COMPLETED`.
58
- * This endpoint is not supported for Private Link workspaces.
59
58
  */
60
59
  async downloadMessageAttachmentVisualization(req, options) {
61
60
  const { host, workspaceId, httpClient } = await this.resolveConfig();
62
61
  const url = `${host}/api/2.0/genie/${req.name ?? ""}/download-visualization`;
63
62
  let resp;
64
63
  const call = async (callSignal) => {
65
- const headers = new Headers();
64
+ const headers = new Headers({ Accept: "application/octet-stream" });
66
65
  if (workspaceId !== void 0) headers.set("X-Databricks-Workspace-Id", workspaceId);
67
66
  headers.set("User-Agent", this.userAgent);
68
67
  resp = { contents: (await sendAndCheckError({
@@ -76,7 +75,31 @@ var GenieClient = class {
76
75
  return resp;
77
76
  }
78
77
  /**
79
- * Create new message in a [conversation](:method:genie/startconversation).
78
+ * Cancels an in-flight agent-mode response. `response_id` is the id returned in the
79
+ * `response.created` event from the agent-mode responses endpoint. The response stops at
80
+ * the next agent boundary and its terminal state is returned.
81
+ */
82
+ async genieCancelResponse(req, options) {
83
+ const { host, workspaceId, httpClient } = await this.resolveConfig();
84
+ const url = `${host}/api/2.0/genie/agents/${req.agentId ?? ""}/conversations/${req.conversationId ?? ""}/responses/${req.responseId ?? ""}/cancel`;
85
+ const body = marshalRequest(req, marshalGenieCancelResponseRequestSchema);
86
+ let resp;
87
+ const call = async (callSignal) => {
88
+ const headers = new Headers({ "Content-Type": "application/json" });
89
+ if (workspaceId !== void 0) headers.set("X-Databricks-Workspace-Id", workspaceId);
90
+ headers.set("User-Agent", this.userAgent);
91
+ resp = parseResponse(await executeHttpCall({
92
+ request: buildHttpRequest("POST", url, headers, callSignal, body),
93
+ httpClient,
94
+ logger: this.logger
95
+ }), unmarshalGenieMessageSchema);
96
+ };
97
+ await executeCall(call, options);
98
+ if (resp === void 0) throw new Error("operation completed without a result.");
99
+ return resp;
100
+ }
101
+ /**
102
+ * Sends a new message in a chat-mode [conversation](:method:genie/startconversation).
80
103
  * The AI response uses all previously created messages in the conversation to respond.
81
104
  */
82
105
  async genieCreateConversationMessageBase(req, options) {
@@ -99,7 +122,7 @@ var GenieClient = class {
99
122
  return resp;
100
123
  }
101
124
  /**
102
- * Create new message in a [conversation](:method:genie/startconversation).
125
+ * Sends a new message in a chat-mode [conversation](:method:genie/startconversation).
103
126
  * The AI response uses all previously created messages in the conversation to respond.
104
127
  */
105
128
  async genieCreateConversationMessage(req, options) {
@@ -109,7 +132,7 @@ var GenieClient = class {
109
132
  if (req.spaceId === void 0) throw new Error("request field spaceId required for polling is missing");
110
133
  return new GenieCreateConversationMessageWaiter(this, resp.messageId, req.conversationId, req.spaceId);
111
134
  }
112
- /** Create and run evaluations for multiple benchmark questions in a Genie space. */
135
+ /** Creates and runs chat-mode evaluations for multiple benchmark questions in a Genie space. */
113
136
  async genieCreateEvalRun(req, options) {
114
137
  const { host, workspaceId, httpClient } = await this.resolveConfig();
115
138
  const url = `${host}/api/2.0/genie/spaces/${req.spaceId ?? ""}/eval-runs`;
@@ -230,17 +253,13 @@ var GenieClient = class {
230
253
  *
231
254
  * ### **Warning: Databricks strongly recommends that you protect the URLs that are returned by the `EXTERNAL_LINKS` disposition.**
232
255
  *
233
- * When you use the `EXTERNAL_LINKS` disposition, a
234
- * short-lived, URL is generated, which can be
235
- * used to download the results directly
236
- * from . As a
237
- * short-lived is
238
- * embedded in this URL, you should protect
239
- * the URL.
256
+ * When you use the `EXTERNAL_LINKS` disposition, a short-lived cloud-storage URL is generated to download the
257
+ * results. The URL contains temporary access credentials, so protect it and do not set an `Authorization` header in
258
+ * the download request.
259
+ *
260
+ *
261
+ *
240
262
  *
241
- * Because URLs are already generated with
242
- * embedded temporary s,
243
- * you must not set an `Authorization` header in the download requests.
244
263
  *
245
264
  * See [Execute Statement](:method:statementexecution/executestatement) for more details.
246
265
  *
@@ -265,7 +284,10 @@ var GenieClient = class {
265
284
  if (resp === void 0) throw new Error("operation completed without a result.");
266
285
  return resp;
267
286
  }
268
- /** Get message from conversation. */
287
+ /**
288
+ * Gets a message from a chat-mode or agent-mode conversation.
289
+ * For a complete agent-mode transcript, use the List conversation items endpoint.
290
+ */
269
291
  async genieGetConversationMessage(req, options) {
270
292
  const { host, workspaceId, httpClient } = await this.resolveConfig();
271
293
  const url = `${host}/api/2.0/genie/spaces/${req.spaceId ?? ""}/conversations/${req.conversationId ?? ""}/messages/${req.messageId ?? ""}`;
@@ -293,17 +315,13 @@ var GenieClient = class {
293
315
  *
294
316
  * ### **Warning: Databricks strongly recommends that you protect the URLs that are returned by the `EXTERNAL_LINKS` disposition.**
295
317
  *
296
- * When you use the `EXTERNAL_LINKS` disposition, a
297
- * short-lived, URL is generated, which can be
298
- * used to download the results directly
299
- * from . As a
300
- * short-lived is
301
- * embedded in this URL, you should protect
302
- * the URL.
318
+ * When you use the `EXTERNAL_LINKS` disposition, a short-lived cloud-storage URL is generated to download the
319
+ * results. The URL contains temporary access credentials, so protect it and do not set an `Authorization` header in
320
+ * the download request.
321
+ *
322
+ *
323
+ *
303
324
  *
304
- * Because URLs are already generated with
305
- * embedded temporary s,
306
- * you must not set an `Authorization` header in the download requests.
307
325
  *
308
326
  * See [Execute Statement](:method:statementexecution/executestatement) for more details.
309
327
  *
@@ -476,7 +494,11 @@ var GenieClient = class {
476
494
  if (resp === void 0) throw new Error("operation completed without a result.");
477
495
  return resp;
478
496
  }
479
- /** List messages in a conversation */
497
+ /**
498
+ * Lists messages in a chat-mode or agent-mode conversation.
499
+ * Agent-mode messages are returned as GenieMessage projections. Use the List conversation items
500
+ * endpoint for the complete reasoning and tool-call history.
501
+ */
480
502
  async genieListConversationMessages(req, options) {
481
503
  const { host, workspaceId, httpClient } = await this.resolveConfig();
482
504
  const url = `${host}/api/2.0/genie/spaces/${req.spaceId ?? ""}/conversations/${req.conversationId ?? ""}/messages`;
@@ -621,7 +643,7 @@ var GenieClient = class {
621
643
  if (resp === void 0) throw new Error("operation completed without a result.");
622
644
  return resp;
623
645
  }
624
- /** Send feedback for a message. */
646
+ /** Sends feedback for a message in a chat-mode or agent-mode conversation. */
625
647
  async genieSendMessageFeedback(req, options) {
626
648
  const { host, workspaceId, httpClient } = await this.resolveConfig();
627
649
  const url = `${host}/api/2.0/genie/spaces/${req.spaceId ?? ""}/conversations/${req.conversationId ?? ""}/messages/${req.messageId ?? ""}/feedback`;
@@ -638,7 +660,7 @@ var GenieClient = class {
638
660
  };
639
661
  await executeCall(call, options);
640
662
  }
641
- /** Start a new conversation. */
663
+ /** Starts a new chat-mode conversation and sends its first message. */
642
664
  async genieStartConversationBase(req, options) {
643
665
  const { host, workspaceId, httpClient } = await this.resolveConfig();
644
666
  const url = `${host}/api/2.0/genie/spaces/${req.spaceId ?? ""}/start-conversation`;
@@ -658,7 +680,7 @@ var GenieClient = class {
658
680
  if (resp === void 0) throw new Error("operation completed without a result.");
659
681
  return resp;
660
682
  }
661
- /** Start a new conversation. */
683
+ /** Starts a new chat-mode conversation and sends its first message. */
662
684
  async genieStartConversation(req, options) {
663
685
  const resp = await this.genieStartConversationBase(req, options);
664
686
  if (resp.messageId === void 0) throw new Error("response field messageId required for polling is missing");