chatroom-cli 1.53.5 → 1.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.
Files changed (201) hide show
  1. package/dist/index.js +5238 -4111
  2. package/dist/index.js.map +45 -33
  3. package/node_modules/@cursor/sdk/LICENSE.md +3 -0
  4. package/node_modules/@cursor/sdk/README.md +5 -0
  5. package/node_modules/@cursor/sdk/dist/cjs/429.index.js +1 -0
  6. package/node_modules/@cursor/sdk/dist/cjs/642.index.js +1 -0
  7. package/node_modules/@cursor/sdk/dist/cjs/745.index.js +8 -0
  8. package/node_modules/@cursor/sdk/dist/cjs/745.index.js.LICENSE.txt +30 -0
  9. package/node_modules/@cursor/sdk/dist/cjs/agent.d.ts +172 -0
  10. package/node_modules/@cursor/sdk/dist/cjs/agent.d.ts.map +1 -0
  11. package/node_modules/@cursor/sdk/dist/cjs/analytics.d.ts +104 -0
  12. package/node_modules/@cursor/sdk/dist/cjs/analytics.d.ts.map +1 -0
  13. package/node_modules/@cursor/sdk/dist/cjs/artifacts.d.ts +6 -0
  14. package/node_modules/@cursor/sdk/dist/cjs/artifacts.d.ts.map +1 -0
  15. package/node_modules/@cursor/sdk/dist/cjs/cloud-agent.d.ts +47 -0
  16. package/node_modules/@cursor/sdk/dist/cjs/cloud-agent.d.ts.map +1 -0
  17. package/node_modules/@cursor/sdk/dist/cjs/cloud-api-client.d.ts +200 -0
  18. package/node_modules/@cursor/sdk/dist/cjs/cloud-api-client.d.ts.map +1 -0
  19. package/node_modules/@cursor/sdk/dist/cjs/cloud-executor.d.ts +14 -0
  20. package/node_modules/@cursor/sdk/dist/cjs/cloud-executor.d.ts.map +1 -0
  21. package/node_modules/@cursor/sdk/dist/cjs/cloud-mcp-utils.d.ts +4 -0
  22. package/node_modules/@cursor/sdk/dist/cjs/cloud-mcp-utils.d.ts.map +1 -0
  23. package/node_modules/@cursor/sdk/dist/cjs/core-adapter.d.ts +2 -0
  24. package/node_modules/@cursor/sdk/dist/cjs/core-adapter.d.ts.map +1 -0
  25. package/node_modules/@cursor/sdk/dist/cjs/custom-tools.d.ts +29 -0
  26. package/node_modules/@cursor/sdk/dist/cjs/custom-tools.d.ts.map +1 -0
  27. package/node_modules/@cursor/sdk/dist/cjs/errors.d.ts +145 -0
  28. package/node_modules/@cursor/sdk/dist/cjs/errors.d.ts.map +1 -0
  29. package/node_modules/@cursor/sdk/dist/cjs/executor-common.d.ts +20 -0
  30. package/node_modules/@cursor/sdk/dist/cjs/executor-common.d.ts.map +1 -0
  31. package/node_modules/@cursor/sdk/dist/cjs/executor-types.d.ts +67 -0
  32. package/node_modules/@cursor/sdk/dist/cjs/executor-types.d.ts.map +1 -0
  33. package/node_modules/@cursor/sdk/dist/cjs/index.d.ts +18 -0
  34. package/node_modules/@cursor/sdk/dist/cjs/index.d.ts.map +1 -0
  35. package/node_modules/@cursor/sdk/dist/cjs/index.js +2 -0
  36. package/node_modules/@cursor/sdk/dist/cjs/index.js.LICENSE.txt +254 -0
  37. package/node_modules/@cursor/sdk/dist/cjs/local-executor.d.ts +20 -0
  38. package/node_modules/@cursor/sdk/dist/cjs/local-executor.d.ts.map +1 -0
  39. package/node_modules/@cursor/sdk/dist/cjs/local-model-validation.d.ts +6 -0
  40. package/node_modules/@cursor/sdk/dist/cjs/local-model-validation.d.ts.map +1 -0
  41. package/node_modules/@cursor/sdk/dist/cjs/messages.d.ts +110 -0
  42. package/node_modules/@cursor/sdk/dist/cjs/messages.d.ts.map +1 -0
  43. package/node_modules/@cursor/sdk/dist/cjs/options.d.ts +236 -0
  44. package/node_modules/@cursor/sdk/dist/cjs/options.d.ts.map +1 -0
  45. package/node_modules/@cursor/sdk/dist/cjs/package.json +3 -0
  46. package/node_modules/@cursor/sdk/dist/cjs/platform.d.ts +72 -0
  47. package/node_modules/@cursor/sdk/dist/cjs/platform.d.ts.map +1 -0
  48. package/node_modules/@cursor/sdk/dist/cjs/prefetched-blobs.d.ts +13 -0
  49. package/node_modules/@cursor/sdk/dist/cjs/prefetched-blobs.d.ts.map +1 -0
  50. package/node_modules/@cursor/sdk/dist/cjs/public-api.d.ts +17 -0
  51. package/node_modules/@cursor/sdk/dist/cjs/public-api.d.ts.map +1 -0
  52. package/node_modules/@cursor/sdk/dist/cjs/run-event-notifier-api.d.ts +120 -0
  53. package/node_modules/@cursor/sdk/dist/cjs/run-event-notifier-api.d.ts.map +1 -0
  54. package/node_modules/@cursor/sdk/dist/cjs/run-event-tailer.d.ts +33 -0
  55. package/node_modules/@cursor/sdk/dist/cjs/run-event-tailer.d.ts.map +1 -0
  56. package/node_modules/@cursor/sdk/dist/cjs/run-interaction-accumulator.d.ts +33 -0
  57. package/node_modules/@cursor/sdk/dist/cjs/run-interaction-accumulator.d.ts.map +1 -0
  58. package/node_modules/@cursor/sdk/dist/cjs/run-store-public-types.d.ts +178 -0
  59. package/node_modules/@cursor/sdk/dist/cjs/run-store-public-types.d.ts.map +1 -0
  60. package/node_modules/@cursor/sdk/dist/cjs/run.d.ts +46 -0
  61. package/node_modules/@cursor/sdk/dist/cjs/run.d.ts.map +1 -0
  62. package/node_modules/@cursor/sdk/dist/cjs/sdk-config.d.ts +24 -0
  63. package/node_modules/@cursor/sdk/dist/cjs/sdk-config.d.ts.map +1 -0
  64. package/node_modules/@cursor/sdk/dist/cjs/sdk-statsig.d.ts +14 -0
  65. package/node_modules/@cursor/sdk/dist/cjs/sdk-statsig.d.ts.map +1 -0
  66. package/node_modules/@cursor/sdk/dist/cjs/store/index.d.ts +8 -0
  67. package/node_modules/@cursor/sdk/dist/cjs/store/index.d.ts.map +1 -0
  68. package/node_modules/@cursor/sdk/dist/cjs/store/jsonl-local-agent-store.d.ts +34 -0
  69. package/node_modules/@cursor/sdk/dist/cjs/store/jsonl-local-agent-store.d.ts.map +1 -0
  70. package/node_modules/@cursor/sdk/dist/cjs/store/local-agent-record-conversion.d.ts +7 -0
  71. package/node_modules/@cursor/sdk/dist/cjs/store/local-agent-record-conversion.d.ts.map +1 -0
  72. package/node_modules/@cursor/sdk/dist/cjs/store/local-agent-store.d.ts +289 -0
  73. package/node_modules/@cursor/sdk/dist/cjs/store/local-agent-store.d.ts.map +1 -0
  74. package/node_modules/@cursor/sdk/dist/cjs/store/sdk-local-defaults.d.ts +15 -0
  75. package/node_modules/@cursor/sdk/dist/cjs/store/sdk-local-defaults.d.ts.map +1 -0
  76. package/node_modules/@cursor/sdk/dist/cjs/store/sdk-state-root.d.ts +6 -0
  77. package/node_modules/@cursor/sdk/dist/cjs/store/sdk-state-root.d.ts.map +1 -0
  78. package/node_modules/@cursor/sdk/dist/cjs/store/sqlite-local-agent-store.d.ts +30 -0
  79. package/node_modules/@cursor/sdk/dist/cjs/store/sqlite-local-agent-store.d.ts.map +1 -0
  80. package/node_modules/@cursor/sdk/dist/cjs/stubs.d.ts +104 -0
  81. package/node_modules/@cursor/sdk/dist/cjs/stubs.d.ts.map +1 -0
  82. package/node_modules/@cursor/sdk/dist/cjs/subagent-conversion.d.ts +22 -0
  83. package/node_modules/@cursor/sdk/dist/cjs/subagent-conversion.d.ts.map +1 -0
  84. package/node_modules/@cursor/sdk/dist/cjs/tool-call-utils.d.ts +7 -0
  85. package/node_modules/@cursor/sdk/dist/cjs/tool-call-utils.d.ts.map +1 -0
  86. package/node_modules/@cursor/sdk/dist/cjs/types/conversation-types.d.ts +12062 -0
  87. package/node_modules/@cursor/sdk/dist/cjs/types/conversation-types.d.ts.map +1 -0
  88. package/node_modules/@cursor/sdk/dist/cjs/types/delta-types.d.ts +2 -0
  89. package/node_modules/@cursor/sdk/dist/cjs/types/delta-types.d.ts.map +1 -0
  90. package/node_modules/@cursor/sdk/dist/cjs/types/tool-call-types.d.ts +2 -0
  91. package/node_modules/@cursor/sdk/dist/cjs/types/tool-call-types.d.ts.map +1 -0
  92. package/node_modules/@cursor/sdk/dist/cjs/utils/conversation-utils.d.ts +3 -0
  93. package/node_modules/@cursor/sdk/dist/cjs/utils/conversation-utils.d.ts.map +1 -0
  94. package/node_modules/@cursor/sdk/dist/cjs/utils/logger.d.ts +12 -0
  95. package/node_modules/@cursor/sdk/dist/cjs/utils/logger.d.ts.map +1 -0
  96. package/node_modules/@cursor/sdk/dist/cjs/utils/message-schemas.d.ts +2 -0
  97. package/node_modules/@cursor/sdk/dist/cjs/utils/message-schemas.d.ts.map +1 -0
  98. package/node_modules/@cursor/sdk/dist/cjs/vendor/cursor-sdk-shared/core-adapter.d.ts +3 -0
  99. package/node_modules/@cursor/sdk/dist/cjs/vendor/cursor-sdk-shared/delta-types.d.ts +19186 -0
  100. package/node_modules/@cursor/sdk/dist/cjs/vendor/cursor-sdk-shared/index.d.ts +4 -0
  101. package/node_modules/@cursor/sdk/dist/cjs/vendor/cursor-sdk-shared/message-schemas.d.ts +105 -0
  102. package/node_modules/@cursor/sdk/dist/cjs/vendor/cursor-sdk-shared/tool-call-types.d.ts +7894 -0
  103. package/node_modules/@cursor/sdk/dist/esm/429.index.js +1 -0
  104. package/node_modules/@cursor/sdk/dist/esm/642.index.js +1 -0
  105. package/node_modules/@cursor/sdk/dist/esm/745.index.js +8 -0
  106. package/node_modules/@cursor/sdk/dist/esm/745.index.js.LICENSE.txt +30 -0
  107. package/node_modules/@cursor/sdk/dist/esm/agent.d.ts +172 -0
  108. package/node_modules/@cursor/sdk/dist/esm/agent.d.ts.map +1 -0
  109. package/node_modules/@cursor/sdk/dist/esm/analytics.d.ts +104 -0
  110. package/node_modules/@cursor/sdk/dist/esm/analytics.d.ts.map +1 -0
  111. package/node_modules/@cursor/sdk/dist/esm/artifacts.d.ts +6 -0
  112. package/node_modules/@cursor/sdk/dist/esm/artifacts.d.ts.map +1 -0
  113. package/node_modules/@cursor/sdk/dist/esm/cloud-agent.d.ts +47 -0
  114. package/node_modules/@cursor/sdk/dist/esm/cloud-agent.d.ts.map +1 -0
  115. package/node_modules/@cursor/sdk/dist/esm/cloud-api-client.d.ts +200 -0
  116. package/node_modules/@cursor/sdk/dist/esm/cloud-api-client.d.ts.map +1 -0
  117. package/node_modules/@cursor/sdk/dist/esm/cloud-executor.d.ts +14 -0
  118. package/node_modules/@cursor/sdk/dist/esm/cloud-executor.d.ts.map +1 -0
  119. package/node_modules/@cursor/sdk/dist/esm/cloud-mcp-utils.d.ts +4 -0
  120. package/node_modules/@cursor/sdk/dist/esm/cloud-mcp-utils.d.ts.map +1 -0
  121. package/node_modules/@cursor/sdk/dist/esm/core-adapter.d.ts +2 -0
  122. package/node_modules/@cursor/sdk/dist/esm/core-adapter.d.ts.map +1 -0
  123. package/node_modules/@cursor/sdk/dist/esm/custom-tools.d.ts +29 -0
  124. package/node_modules/@cursor/sdk/dist/esm/custom-tools.d.ts.map +1 -0
  125. package/node_modules/@cursor/sdk/dist/esm/errors.d.ts +145 -0
  126. package/node_modules/@cursor/sdk/dist/esm/errors.d.ts.map +1 -0
  127. package/node_modules/@cursor/sdk/dist/esm/executor-common.d.ts +20 -0
  128. package/node_modules/@cursor/sdk/dist/esm/executor-common.d.ts.map +1 -0
  129. package/node_modules/@cursor/sdk/dist/esm/executor-types.d.ts +67 -0
  130. package/node_modules/@cursor/sdk/dist/esm/executor-types.d.ts.map +1 -0
  131. package/node_modules/@cursor/sdk/dist/esm/index.d.ts +18 -0
  132. package/node_modules/@cursor/sdk/dist/esm/index.d.ts.map +1 -0
  133. package/node_modules/@cursor/sdk/dist/esm/index.js +2 -0
  134. package/node_modules/@cursor/sdk/dist/esm/index.js.LICENSE.txt +254 -0
  135. package/node_modules/@cursor/sdk/dist/esm/local-executor.d.ts +20 -0
  136. package/node_modules/@cursor/sdk/dist/esm/local-executor.d.ts.map +1 -0
  137. package/node_modules/@cursor/sdk/dist/esm/local-model-validation.d.ts +6 -0
  138. package/node_modules/@cursor/sdk/dist/esm/local-model-validation.d.ts.map +1 -0
  139. package/node_modules/@cursor/sdk/dist/esm/messages.d.ts +110 -0
  140. package/node_modules/@cursor/sdk/dist/esm/messages.d.ts.map +1 -0
  141. package/node_modules/@cursor/sdk/dist/esm/options.d.ts +236 -0
  142. package/node_modules/@cursor/sdk/dist/esm/options.d.ts.map +1 -0
  143. package/node_modules/@cursor/sdk/dist/esm/platform.d.ts +72 -0
  144. package/node_modules/@cursor/sdk/dist/esm/platform.d.ts.map +1 -0
  145. package/node_modules/@cursor/sdk/dist/esm/prefetched-blobs.d.ts +13 -0
  146. package/node_modules/@cursor/sdk/dist/esm/prefetched-blobs.d.ts.map +1 -0
  147. package/node_modules/@cursor/sdk/dist/esm/public-api.d.ts +17 -0
  148. package/node_modules/@cursor/sdk/dist/esm/public-api.d.ts.map +1 -0
  149. package/node_modules/@cursor/sdk/dist/esm/run-event-notifier-api.d.ts +120 -0
  150. package/node_modules/@cursor/sdk/dist/esm/run-event-notifier-api.d.ts.map +1 -0
  151. package/node_modules/@cursor/sdk/dist/esm/run-event-tailer.d.ts +33 -0
  152. package/node_modules/@cursor/sdk/dist/esm/run-event-tailer.d.ts.map +1 -0
  153. package/node_modules/@cursor/sdk/dist/esm/run-interaction-accumulator.d.ts +33 -0
  154. package/node_modules/@cursor/sdk/dist/esm/run-interaction-accumulator.d.ts.map +1 -0
  155. package/node_modules/@cursor/sdk/dist/esm/run-store-public-types.d.ts +178 -0
  156. package/node_modules/@cursor/sdk/dist/esm/run-store-public-types.d.ts.map +1 -0
  157. package/node_modules/@cursor/sdk/dist/esm/run.d.ts +46 -0
  158. package/node_modules/@cursor/sdk/dist/esm/run.d.ts.map +1 -0
  159. package/node_modules/@cursor/sdk/dist/esm/sdk-config.d.ts +24 -0
  160. package/node_modules/@cursor/sdk/dist/esm/sdk-config.d.ts.map +1 -0
  161. package/node_modules/@cursor/sdk/dist/esm/sdk-statsig.d.ts +14 -0
  162. package/node_modules/@cursor/sdk/dist/esm/sdk-statsig.d.ts.map +1 -0
  163. package/node_modules/@cursor/sdk/dist/esm/store/index.d.ts +8 -0
  164. package/node_modules/@cursor/sdk/dist/esm/store/index.d.ts.map +1 -0
  165. package/node_modules/@cursor/sdk/dist/esm/store/jsonl-local-agent-store.d.ts +34 -0
  166. package/node_modules/@cursor/sdk/dist/esm/store/jsonl-local-agent-store.d.ts.map +1 -0
  167. package/node_modules/@cursor/sdk/dist/esm/store/local-agent-record-conversion.d.ts +7 -0
  168. package/node_modules/@cursor/sdk/dist/esm/store/local-agent-record-conversion.d.ts.map +1 -0
  169. package/node_modules/@cursor/sdk/dist/esm/store/local-agent-store.d.ts +289 -0
  170. package/node_modules/@cursor/sdk/dist/esm/store/local-agent-store.d.ts.map +1 -0
  171. package/node_modules/@cursor/sdk/dist/esm/store/sdk-local-defaults.d.ts +15 -0
  172. package/node_modules/@cursor/sdk/dist/esm/store/sdk-local-defaults.d.ts.map +1 -0
  173. package/node_modules/@cursor/sdk/dist/esm/store/sdk-state-root.d.ts +6 -0
  174. package/node_modules/@cursor/sdk/dist/esm/store/sdk-state-root.d.ts.map +1 -0
  175. package/node_modules/@cursor/sdk/dist/esm/store/sqlite-local-agent-store.d.ts +30 -0
  176. package/node_modules/@cursor/sdk/dist/esm/store/sqlite-local-agent-store.d.ts.map +1 -0
  177. package/node_modules/@cursor/sdk/dist/esm/stubs.d.ts +104 -0
  178. package/node_modules/@cursor/sdk/dist/esm/stubs.d.ts.map +1 -0
  179. package/node_modules/@cursor/sdk/dist/esm/subagent-conversion.d.ts +22 -0
  180. package/node_modules/@cursor/sdk/dist/esm/subagent-conversion.d.ts.map +1 -0
  181. package/node_modules/@cursor/sdk/dist/esm/tool-call-utils.d.ts +7 -0
  182. package/node_modules/@cursor/sdk/dist/esm/tool-call-utils.d.ts.map +1 -0
  183. package/node_modules/@cursor/sdk/dist/esm/types/conversation-types.d.ts +12062 -0
  184. package/node_modules/@cursor/sdk/dist/esm/types/conversation-types.d.ts.map +1 -0
  185. package/node_modules/@cursor/sdk/dist/esm/types/delta-types.d.ts +2 -0
  186. package/node_modules/@cursor/sdk/dist/esm/types/delta-types.d.ts.map +1 -0
  187. package/node_modules/@cursor/sdk/dist/esm/types/tool-call-types.d.ts +2 -0
  188. package/node_modules/@cursor/sdk/dist/esm/types/tool-call-types.d.ts.map +1 -0
  189. package/node_modules/@cursor/sdk/dist/esm/utils/conversation-utils.d.ts +3 -0
  190. package/node_modules/@cursor/sdk/dist/esm/utils/conversation-utils.d.ts.map +1 -0
  191. package/node_modules/@cursor/sdk/dist/esm/utils/logger.d.ts +12 -0
  192. package/node_modules/@cursor/sdk/dist/esm/utils/logger.d.ts.map +1 -0
  193. package/node_modules/@cursor/sdk/dist/esm/utils/message-schemas.d.ts +2 -0
  194. package/node_modules/@cursor/sdk/dist/esm/utils/message-schemas.d.ts.map +1 -0
  195. package/node_modules/@cursor/sdk/dist/esm/vendor/cursor-sdk-shared/core-adapter.d.ts +3 -0
  196. package/node_modules/@cursor/sdk/dist/esm/vendor/cursor-sdk-shared/delta-types.d.ts +19186 -0
  197. package/node_modules/@cursor/sdk/dist/esm/vendor/cursor-sdk-shared/index.d.ts +4 -0
  198. package/node_modules/@cursor/sdk/dist/esm/vendor/cursor-sdk-shared/message-schemas.d.ts +105 -0
  199. package/node_modules/@cursor/sdk/dist/esm/vendor/cursor-sdk-shared/tool-call-types.d.ts +7894 -0
  200. package/node_modules/@cursor/sdk/package.json +109 -0
  201. package/package.json +6 -19
@@ -0,0 +1,30 @@
1
+ /*!
2
+ * is-extendable <https://github.com/jonschlinkert/is-extendable>
3
+ *
4
+ * Copyright (c) 2015, Jon Schlinkert.
5
+ * Licensed under the MIT License.
6
+ */
7
+
8
+ /*!
9
+ * re2js
10
+ * RE2JS is the JavaScript port of RE2, a regular expression engine that provides linear time matching
11
+ *
12
+ * @version v1.2.2
13
+ * @author Alexey Vasiliev
14
+ * @homepage https://github.com/le0pard/re2js#readme
15
+ * @repository github:le0pard/re2js
16
+ * @license MIT
17
+ */
18
+
19
+ /*!
20
+ * strip-bom-string <https://github.com/jonschlinkert/strip-bom-string>
21
+ *
22
+ * Copyright (c) 2015, 2017, Jon Schlinkert.
23
+ * Released under the MIT License.
24
+ */
25
+
26
+ /*! formdata-polyfill. MIT License. Jimmy Wärting <https://jimmy.warting.se/opensource> */
27
+
28
+ /*! js-yaml 4.1.0 https://github.com/nodeca/js-yaml @license MIT */
29
+
30
+ /*! ws. MIT License. Einar Otto Stangvik <einaros@gmail.com> */
@@ -0,0 +1,172 @@
1
+ import type { AgentModeOption, LocalSendOptions, McpServerConfig, ModelListItem, ModelSelection, SDKUserMessage } from "./options.js";
2
+ import type { Run } from "./run.js";
3
+ import type { LocalAgentStore } from "./store/local-agent-store.js";
4
+ import type { ConversationStep } from "./types/conversation-types.js";
5
+ import type { InteractionUpdate } from "./types/delta-types.js";
6
+ export interface SDKAgent {
7
+ readonly agentId: string;
8
+ /**
9
+ * The agent's current model selection. Updated after each successful
10
+ * `send({ model })`; `undefined` until something sets it.
11
+ */
12
+ readonly model: ModelSelection | undefined;
13
+ send(message: string | SDKUserMessage, options?: SendOptions): Promise<Run>;
14
+ close(): void;
15
+ reload(): Promise<void>;
16
+ [Symbol.asyncDispose](): Promise<void>;
17
+ listArtifacts(): Promise<import("./artifacts.js").SDKArtifact[]>;
18
+ downloadArtifact(path: string): Promise<Buffer>;
19
+ }
20
+ export interface SendOptions {
21
+ model?: ModelSelection;
22
+ mcpServers?: Record<string, McpServerConfig>;
23
+ /** Conversation mode for this send. */
24
+ mode?: AgentModeOption;
25
+ onStep?: (args: {
26
+ step: ConversationStep;
27
+ }) => void | Promise<void>;
28
+ onDelta?: (args: {
29
+ update: InteractionUpdate;
30
+ }) => void | Promise<void>;
31
+ /**
32
+ * Per-send options that only apply to local agents. Nested to make the
33
+ * local-only scope explicit at the type level — cloud callers cannot
34
+ * pass these fields.
35
+ */
36
+ local?: LocalSendOptions;
37
+ idempotencyKey?: string;
38
+ }
39
+ export type ListAgentsOptions = {
40
+ limit?: number;
41
+ cursor?: string;
42
+ } & ({
43
+ runtime?: undefined;
44
+ } | {
45
+ runtime: "local";
46
+ cwd?: string;
47
+ store?: LocalAgentStore;
48
+ } | {
49
+ runtime: "cloud";
50
+ prUrl?: string;
51
+ includeArchived?: boolean;
52
+ apiKey?: string;
53
+ });
54
+ export interface ListResult<T> {
55
+ items: T[];
56
+ nextCursor?: string;
57
+ }
58
+ export type SDKAgentInfo = {
59
+ agentId: string;
60
+ name: string;
61
+ summary: string;
62
+ lastModified: number;
63
+ status?: "running" | "finished" | "error";
64
+ createdAt?: number;
65
+ /**
66
+ * True when the agent has been archived via `Agent.archive(...)`. Distinct
67
+ * from `status` (which reflects the most recent run's execution state).
68
+ * Backwards-compatible optional field; undefined on older shapes.
69
+ */
70
+ archived?: boolean;
71
+ } & ({
72
+ runtime?: undefined;
73
+ } | {
74
+ runtime: "local";
75
+ cwd?: string;
76
+ } | {
77
+ runtime: "cloud";
78
+ env?: {
79
+ type: "cloud" | "pool" | "machine";
80
+ name?: string;
81
+ };
82
+ repos?: string[];
83
+ });
84
+ export type ListRunsOptions = {
85
+ limit?: number;
86
+ cursor?: string;
87
+ } & ({
88
+ runtime?: "local";
89
+ cwd?: string;
90
+ store?: LocalAgentStore;
91
+ } | {
92
+ runtime: "cloud";
93
+ apiKey?: string;
94
+ });
95
+ export interface GetAgentMessagesOptions {
96
+ limit?: number;
97
+ offset?: number;
98
+ runtime?: "local";
99
+ cwd?: string;
100
+ store?: LocalAgentStore;
101
+ }
102
+ export type GetRunOptions = {
103
+ runtime?: "local";
104
+ cwd?: string;
105
+ store?: LocalAgentStore;
106
+ } | {
107
+ runtime: "cloud";
108
+ agentId: string;
109
+ apiKey?: string;
110
+ };
111
+ export interface AgentMessage {
112
+ type: "user" | "assistant";
113
+ uuid: string;
114
+ agent_id: string;
115
+ message: unknown;
116
+ }
117
+ /**
118
+ * Options for `Agent.get` / `Agent.archive` / `Agent.unarchive` /
119
+ * `Agent.delete`.
120
+ *
121
+ * Runtime is auto-detected from the agent ID: IDs that start with `"bc-"`
122
+ * route to the Cursor cloud API, everything else routes to the local store.
123
+ *
124
+ * - `cwd` is used when routing to the local store (defaults to `process.cwd()`).
125
+ * - `store` overrides the module default from `Cursor.configure({ local: { store } })`.
126
+ * - `apiKey` is used when routing to the cloud API (falls back to
127
+ * `process.env.CURSOR_API_KEY`).
128
+ */
129
+ export interface GetAgentOptions {
130
+ cwd?: string;
131
+ apiKey?: string;
132
+ store?: LocalAgentStore;
133
+ }
134
+ export interface AgentOperationOptions {
135
+ cwd?: string;
136
+ apiKey?: string;
137
+ store?: LocalAgentStore;
138
+ }
139
+ /**
140
+ * Options for cloud-only account/catalog operations (Cursor.me, Cursor.models.list,
141
+ * Cursor.repositories.list). If `apiKey` is omitted, falls back to
142
+ * `process.env.CURSOR_API_KEY`.
143
+ */
144
+ export interface CursorRequestOptions {
145
+ apiKey?: string;
146
+ }
147
+ export interface SDKUser {
148
+ /** Display name of the API key used to authenticate the request. */
149
+ apiKeyName: string;
150
+ /**
151
+ * Numeric Cursor user id of the API key's owner. `undefined` for team /
152
+ * service-account API keys, which aren't tied to a specific user.
153
+ */
154
+ userId?: number;
155
+ /** Email of the user that owns the API key, when available. */
156
+ userEmail?: string;
157
+ /** First name of the user that owns the API key, when available. */
158
+ userFirstName?: string;
159
+ /** Last name of the user that owns the API key, when available. */
160
+ userLastName?: string;
161
+ /** ISO 8601 timestamp of when the API key was created. */
162
+ createdAt: string;
163
+ }
164
+ export interface SDKRepository {
165
+ url: string;
166
+ }
167
+ /**
168
+ * An entry returned by `Cursor.models.list()`. The `model` field is a
169
+ * canonical `{ id, params }` that can be passed straight to `createAgent`.
170
+ */
171
+ export type SDKModel = ModelListItem;
172
+ //# sourceMappingURL=agent.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/agent/agent.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,104 @@
1
+ import { type TokenProvider } from "@anysphere/analytics-client";
2
+ /**
3
+ * Drains buffered SDK analytics events for every apiKey that has emitted
4
+ * anything in this process. Called from `agent[Symbol.asyncDispose]()`.
5
+ *
6
+ * `timeoutMs` bounds the wait; if the RPC hangs, flush aborts via the
7
+ * internal AbortController and returns. Never throws.
8
+ */
9
+ export declare function flushSdkAnalytics(timeoutMs?: number): Promise<void>;
10
+ export declare function __resetAnalyticsForTests(): void;
11
+ /**
12
+ * Four dispatch targets, flattened into one field so a single
13
+ * `WHERE runtime = 'X'` or `WHERE runtime != 'local'` query covers both
14
+ * "which execution environment?" and "is this local?" questions without
15
+ * awkwardly repeating "cloud" at two nesting levels.
16
+ */
17
+ export type SdkRuntime = "local" | "cloud" | "pool" | "machine";
18
+ /**
19
+ * Base props auto-merged into every SDK event by the analytics wrapper.
20
+ * Callers never pass these. Kept as an interface (not derived) so the DBT
21
+ * generator at `scripts/generate-dbt-from-analytics-types.ts` can resolve
22
+ * them — its AST walker only looks at interface declarations in the same
23
+ * source file.
24
+ */
25
+ export interface SdkAnalyticsBaseProps {
26
+ /** Runtime surface emitting telemetry. Always "sdk" for this package. */
27
+ surface: "sdk";
28
+ /** Version of @cursor/sdk that emitted the event. */
29
+ sdk_version: string;
30
+ /** Node process.platform (e.g., "darwin", "linux", "win32"). */
31
+ os_platform: string;
32
+ /** Node process.arch (e.g., "x64", "arm64"). */
33
+ os_arch: string;
34
+ }
35
+ export interface SdkRunCreatedProps {
36
+ agent_id: string;
37
+ run_id: string;
38
+ /** Backend request id used for the SDK turn, when the runtime exposes it. */
39
+ request_id?: string;
40
+ runtime: SdkRuntime;
41
+ model: string;
42
+ /**
43
+ * JSON-encoded `ModelSelection.params` (`[{ id, value }, ...]`) when the
44
+ * caller supplied any. Omitted when no params were set.
45
+ */
46
+ model_params?: string;
47
+ prompt_length: number;
48
+ has_images: boolean;
49
+ is_resume: boolean;
50
+ mcp_server_count: number;
51
+ cloud_repo_count?: number;
52
+ cloud_auto_create_pr?: boolean;
53
+ }
54
+ export interface SdkRunCompletedProps {
55
+ agent_id: string;
56
+ run_id: string;
57
+ /** Backend request id used for the SDK turn, when the runtime exposes it. */
58
+ request_id?: string;
59
+ runtime: SdkRuntime;
60
+ end_reason: "success" | "error" | "abort";
61
+ }
62
+ export interface SdkRunSendLatencyProps {
63
+ agent_id: string;
64
+ run_id: string;
65
+ /** Backend request id used for the SDK turn, when the runtime exposes it. */
66
+ request_id?: string;
67
+ runtime: SdkRuntime;
68
+ is_resume: boolean;
69
+ is_first_send_after_resume: boolean;
70
+ cold_executor: boolean;
71
+ executor_acquire_ms: number;
72
+ load_latest_ms: number;
73
+ get_blob_store_ms: number;
74
+ pre_send_ms: number;
75
+ time_to_first_message_ms?: number;
76
+ terminated_reason: "success" | "error" | "abort" | "hang_timeout";
77
+ turn_count: number;
78
+ }
79
+ export interface SdkExecutorStartupProps {
80
+ runtime: SdkRuntime;
81
+ ensure_ghost_mode_ms: number;
82
+ bootstrap_statsig_ms: number;
83
+ create_workspace_runtime_ms: number;
84
+ load_sandbox_policy_ms: number;
85
+ total_ms: number;
86
+ }
87
+ /**
88
+ * Schema consumed by the DBT generator. The runtime emit path in this file
89
+ * auto-merges SdkAnalyticsBaseProps into every event, so this intersection
90
+ * mirrors the actual wire shape and generates the right SQL columns.
91
+ *
92
+ * Do not reference this from runtime code — it exists purely for dbt.
93
+ */
94
+ export type SdkAnalyticsEventSchema = {
95
+ "sdk.run.created": SdkAnalyticsBaseProps & SdkRunCreatedProps;
96
+ "sdk.run.completed": SdkAnalyticsBaseProps & SdkRunCompletedProps;
97
+ "sdk.run.send_latency": SdkAnalyticsBaseProps & SdkRunSendLatencyProps;
98
+ "sdk.executor.startup": SdkAnalyticsBaseProps & SdkExecutorStartupProps;
99
+ };
100
+ export declare function trackSdkRunCreated(apiKey: string | undefined, props: SdkRunCreatedProps): void;
101
+ export declare function trackSdkRunCompleted(apiKey: string | undefined, props: SdkRunCompletedProps): void;
102
+ export declare function trackSdkRunSendLatency(apiKey: string | undefined, props: SdkRunSendLatencyProps): void;
103
+ export type { TokenProvider };
104
+ //# sourceMappingURL=analytics.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/agent/analytics.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ export interface SDKArtifact {
2
+ path: string;
3
+ sizeBytes: number;
4
+ updatedAt: string;
5
+ }
6
+ //# sourceMappingURL=artifacts.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/agent/artifacts.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB"}
@@ -0,0 +1,47 @@
1
+ import type { AgentOperationOptions, CursorRequestOptions, GetAgentOptions, GetRunOptions, ListAgentsOptions, ListResult, ListRunsOptions, SDKAgent, SDKAgentInfo, SDKModel, SDKRepository, SDKUser } from "./agent.js";
2
+ import type { AgentOptions, ModelSelection } from "./options.js";
3
+ import type { Run } from "./run.js";
4
+ export declare function createCloudAgent(options: AgentOptions): SDKAgent;
5
+ /**
6
+ * Pre-flight check that `model` is in the catalog returned by
7
+ * `Cursor.models.list()`. Surfaces bogus-model failures at create time
8
+ * instead of mid-stream during the first `send()`.
9
+ *
10
+ * If the catalog call fails with a `NetworkError`, `AuthenticationError`,
11
+ * or `RateLimitError` the check is best-effort-skipped — the user has
12
+ * bigger problems than a bad model id, and backend `validateModelSelection`
13
+ * becomes the source of truth in that case. Other error classes (programmer
14
+ * errors, ApiError 5xx, unexpected throws) propagate so they aren't
15
+ * silently lost.
16
+ *
17
+ * NOTE: today `createDefaultAgent` is the only caller; `createCloudAgent`
18
+ * does not invoke this helper itself, so direct cloud-agent callers bypass
19
+ * the pre-flight. P3.4 of the structural review tracks moving the call into
20
+ * `createCloudAgent` itself, but that turns it into an async constructor and
21
+ * touches every `createCloudAgent` call site. Deferred to its own PR.
22
+ */
23
+ export declare function validateCloudModelAvailability({ apiKey, model, }: {
24
+ apiKey: string | undefined;
25
+ model: ModelSelection | string;
26
+ }): Promise<void>;
27
+ export declare function resumeCloudAgent(agentId: string, options: Partial<AgentOptions>): SDKAgent;
28
+ export declare function listCloudAgents(options: Extract<ListAgentsOptions, {
29
+ runtime: "cloud";
30
+ }>): Promise<ListResult<SDKAgentInfo>>;
31
+ export declare function listCloudRuns(agentId: string, options: Extract<ListRunsOptions, {
32
+ runtime: "cloud";
33
+ }>): Promise<ListResult<Run>>;
34
+ export declare function getCloudRun(runId: string, options: Extract<GetRunOptions, {
35
+ runtime: "cloud";
36
+ }>): Promise<Run>;
37
+ export declare function cancelCloudRun(runId: string, options: Extract<GetRunOptions, {
38
+ runtime: "cloud";
39
+ }>): Promise<void>;
40
+ export declare function getCloudAgent(agentId: string, options: GetAgentOptions): Promise<SDKAgentInfo>;
41
+ export declare function archiveCloudAgent(agentId: string, options: AgentOperationOptions): Promise<void>;
42
+ export declare function unarchiveCloudAgent(agentId: string, options: AgentOperationOptions): Promise<void>;
43
+ export declare function deleteCloudAgent(agentId: string, options: AgentOperationOptions): Promise<void>;
44
+ export declare function getCloudMe(options: CursorRequestOptions): Promise<SDKUser>;
45
+ export declare function listCloudModels(options: CursorRequestOptions): Promise<SDKModel[]>;
46
+ export declare function listCloudRepositories(options: CursorRequestOptions): Promise<SDKRepository[]>;
47
+ //# sourceMappingURL=cloud-agent.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cloud-agent.d.ts","sourceRoot":"","sources":["../../src/agent/cloud-agent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,QAAQ,EACR,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,OAAO,EAER,MAAM,YAAY,CAAC;AAgCpB,OAAO,KAAK,EACV,YAAY,EAEZ,cAAc,EAEf,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EACV,GAAG,EAKJ,MAAM,UAAU,CAAC;AAimClB,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,QAAQ,CAWhE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,8BAA8B,CAAC,EACnD,MAAM,EACN,KAAK,GACN,EAAE;IACD,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,EAAE,cAAc,GAAG,MAAM,CAAC;CAChC,GAAG,OAAO,CAAC,IAAI,CAAC,CAsEhB;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAC7B,QAAQ,CASV;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,OAAO,CAAC,iBAAiB,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,GACxD,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAanC;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,CAAC,eAAe,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,GACtD,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAW1B;AAED,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,CAAC,aAAa,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,GACpD,OAAO,CAAC,GAAG,CAAC,CAOd;AAED,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,CAAC,aAAa,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,GACpD,OAAO,CAAC,IAAI,CAAC,CAMf;AAgBD,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,YAAY,CAAC,CAKvB;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,UAAU,CAC9B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,OAAO,CAAC,CAIlB;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,QAAQ,EAAE,CAAC,CAKrB;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,aAAa,EAAE,CAAC,CAK1B"}
@@ -0,0 +1,200 @@
1
+ import type { RunResultMetadata } from "./executor-types.js";
2
+ import type { McpServerConfig, ModelListItem, ModelSelection } from "./options.js";
3
+ export type V1Image = {
4
+ url: string;
5
+ dimension?: {
6
+ width: number;
7
+ height: number;
8
+ };
9
+ } | {
10
+ data: string;
11
+ mimeType: string;
12
+ dimension?: {
13
+ width: number;
14
+ height: number;
15
+ };
16
+ };
17
+ export interface V1Prompt {
18
+ text: string;
19
+ images?: V1Image[];
20
+ }
21
+ export interface V1Env {
22
+ type: "cloud" | "pool" | "machine";
23
+ name?: string;
24
+ }
25
+ export interface V1Repository {
26
+ url: string;
27
+ startingRef?: string;
28
+ prUrl?: string;
29
+ }
30
+ type V1StdioMcpServerConfig = Omit<Extract<McpServerConfig, {
31
+ command: string;
32
+ }>, "cwd">;
33
+ type V1RemoteMcpServerConfig = Extract<McpServerConfig, {
34
+ url: string;
35
+ }>;
36
+ export type V1McpServer = (V1StdioMcpServerConfig | V1RemoteMcpServerConfig) & {
37
+ name: string;
38
+ };
39
+ export interface V1CustomSubagent {
40
+ name: string;
41
+ description: string;
42
+ prompt: string;
43
+ model?: ModelSelection | string;
44
+ }
45
+ export interface V1CreateAgentRequest {
46
+ agentId?: string;
47
+ prompt: V1Prompt;
48
+ model?: ModelSelection;
49
+ name?: string;
50
+ mcpServers?: V1McpServer[];
51
+ customSubagents?: V1CustomSubagent[];
52
+ env?: V1Env;
53
+ envVars?: Record<string, string>;
54
+ repos?: V1Repository[];
55
+ workOnCurrentBranch?: boolean;
56
+ autoCreatePR?: boolean;
57
+ skipReviewerRequest?: boolean;
58
+ mode?: "agent" | "plan";
59
+ }
60
+ export interface V1CreateRunRequest {
61
+ prompt: V1Prompt;
62
+ mcpServers?: V1McpServer[];
63
+ model?: ModelSelection;
64
+ mode?: "agent" | "plan";
65
+ }
66
+ export interface V1Agent {
67
+ id: string;
68
+ name?: string;
69
+ status: "ACTIVE" | "ARCHIVED";
70
+ env?: V1Env;
71
+ repos?: Array<{
72
+ url: string;
73
+ startingRef?: string;
74
+ prUrl?: string;
75
+ }>;
76
+ workOnCurrentBranch?: boolean;
77
+ autoCreatePR?: boolean;
78
+ skipReviewerRequest?: boolean;
79
+ customSubagents?: V1CustomSubagent[];
80
+ url: string;
81
+ createdAt: string;
82
+ updatedAt: string;
83
+ latestRunId?: string;
84
+ }
85
+ export interface V1Run {
86
+ id: string;
87
+ agentId: string;
88
+ requestId?: string;
89
+ status: "CREATING" | "RUNNING" | "FINISHED" | "ERROR" | "CANCELLED" | "EXPIRED";
90
+ createdAt: string;
91
+ updatedAt: string;
92
+ durationMs?: number;
93
+ result?: string;
94
+ git?: {
95
+ branches: Array<{
96
+ repoUrl: string;
97
+ branch?: string;
98
+ prUrl?: string;
99
+ }>;
100
+ };
101
+ }
102
+ export interface V1Artifact {
103
+ path: string;
104
+ sizeBytes: number;
105
+ updatedAt: string;
106
+ }
107
+ export interface V1MeResponse {
108
+ apiKeyName: string;
109
+ /**
110
+ * Numeric Cursor user id of the API key's owner. Absent for team /
111
+ * service-account API keys, which aren't owned by a specific user.
112
+ */
113
+ userId?: number;
114
+ userEmail?: string;
115
+ userFirstName?: string;
116
+ userLastName?: string;
117
+ createdAt: string;
118
+ }
119
+ export interface V1GitHubRepository {
120
+ url: string;
121
+ }
122
+ export interface V1ListResult<T> {
123
+ items: T[];
124
+ nextCursor?: string;
125
+ }
126
+ export interface V1RunPathParams {
127
+ agentId: string;
128
+ runId: string;
129
+ }
130
+ export declare function mapV1RunResultMetadataToSdk(run: Partial<Pick<V1Run, "status" | "result" | "durationMs" | "git">>): RunResultMetadata;
131
+ export declare class CloudApiClient {
132
+ private readonly baseUrl;
133
+ private readonly apiKey;
134
+ private readonly isLocalhost;
135
+ private readonly useLocalNonVm;
136
+ constructor(apiKey: string, baseUrl?: string);
137
+ private headers;
138
+ private request;
139
+ private throwApiError;
140
+ createAgent(req: V1CreateAgentRequest, options?: {
141
+ idempotencyKey?: string;
142
+ }): Promise<{
143
+ agent: V1Agent & {
144
+ latestRunId: string;
145
+ };
146
+ run: V1Run;
147
+ }>;
148
+ getAgent(agentId: string): Promise<V1Agent>;
149
+ listAgents(params?: {
150
+ limit?: number;
151
+ cursor?: string;
152
+ prUrl?: string;
153
+ includeArchived?: boolean;
154
+ }): Promise<V1ListResult<V1Agent>>;
155
+ archiveAgent(agentId: string): Promise<{
156
+ id: string;
157
+ }>;
158
+ unarchiveAgent(agentId: string): Promise<{
159
+ id: string;
160
+ }>;
161
+ deleteAgent(agentId: string): Promise<{
162
+ id: string;
163
+ }>;
164
+ createRun(agentId: string, req: V1CreateRunRequest, options?: {
165
+ idempotencyKey?: string;
166
+ }): Promise<{
167
+ run: V1Run;
168
+ }>;
169
+ listRuns(agentId: string, params?: {
170
+ limit?: number;
171
+ cursor?: string;
172
+ }): Promise<V1ListResult<V1Run>>;
173
+ getRun({ agentId, runId }: V1RunPathParams): Promise<V1Run>;
174
+ cancelRun({ agentId, runId, }: V1RunPathParams): Promise<{
175
+ id: string;
176
+ }>;
177
+ streamRun({ agentId, runId, lastEventId, signal, }: V1RunPathParams & {
178
+ lastEventId?: string;
179
+ signal?: AbortSignal;
180
+ }): Promise<Response>;
181
+ listArtifacts(agentId: string): Promise<{
182
+ items: V1Artifact[];
183
+ }>;
184
+ getArtifactDownloadUrl({ agentId, path, }: {
185
+ agentId: string;
186
+ path: string;
187
+ }): Promise<{
188
+ url: string;
189
+ expiresAt: string;
190
+ }>;
191
+ getMe(): Promise<V1MeResponse>;
192
+ listModels(): Promise<{
193
+ items: ModelListItem[];
194
+ }>;
195
+ listRepositories(): Promise<{
196
+ items: V1GitHubRepository[];
197
+ }>;
198
+ }
199
+ export {};
200
+ //# sourceMappingURL=cloud-api-client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cloud-api-client.d.ts","sourceRoot":"","sources":["../../src/agent/cloud-api-client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ import { type CloudApiClient } from "./cloud-api-client.js";
2
+ import type { CloudExecutorConfig, RunExecutor } from "./executor-types.js";
3
+ import type { InteractionUpdate } from "./types/delta-types.js";
4
+ type ToolCallStatus = "running" | "completed" | "error";
5
+ export declare function mapV1RunStreamEventToSdkUpdate(raw: unknown): (InteractionUpdate & {
6
+ status?: ToolCallStatus;
7
+ }) | null | undefined;
8
+ export interface CloudExecutorCallbacks {
9
+ onAgentCreated?: (agentId: string) => void;
10
+ onRunCreated?: (runId: string) => void;
11
+ }
12
+ export declare function createCloudExecutor(client: CloudApiClient, config: CloudExecutorConfig, callbacks?: CloudExecutorCallbacks): Promise<RunExecutor>;
13
+ export {};
14
+ //# sourceMappingURL=cloud-executor.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cloud-executor.d.ts","sourceRoot":"","sources":["../../src/agent/cloud-executor.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,cAAc,EAGpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EACV,mBAAmB,EACnB,WAAW,EAKZ,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAOhE,KAAK,cAAc,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;AAExD,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,OAAO,GACX,CAAC,iBAAiB,GAAG;IAAE,MAAM,CAAC,EAAE,cAAc,CAAA;CAAE,CAAC,GAAG,IAAI,GAAG,SAAS,CAiCtE;AAgFD,MAAM,WAAW,sBAAsB;IACrC,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,mBAAmB,EAC3B,SAAS,CAAC,EAAE,sBAAsB,GACjC,OAAO,CAAC,WAAW,CAAC,CAgQtB"}
@@ -0,0 +1,4 @@
1
+ import type { V1CreateAgentRequest } from "./cloud-api-client.js";
2
+ import type { AgentOptions } from "./options.js";
3
+ export declare function buildV1McpServers(mcpServers: AgentOptions["mcpServers"]): V1CreateAgentRequest["mcpServers"];
4
+ //# sourceMappingURL=cloud-mcp-utils.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cloud-mcp-utils.d.ts","sourceRoot":"","sources":["../../src/agent/cloud-mcp-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,YAAY,CAAC,YAAY,CAAC,GACrC,oBAAoB,CAAC,YAAY,CAAC,CAmBpC"}
@@ -0,0 +1,2 @@
1
+ export * from "vendor/cursor-sdk-shared/core-adapter.js";
2
+ //# sourceMappingURL=core-adapter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"core-adapter.d.ts","sourceRoot":"","sources":["../../src/agent/core-adapter.ts"],"names":[],"mappings":"AAAA,cAAc,2CAA2C,CAAC"}
@@ -0,0 +1,29 @@
1
+ import { type McpExecutor, type NamedMcpToolDefinition } from "@anysphere/agent-exec";
2
+ import type { SDKCustomTool } from "./options.js";
3
+ /**
4
+ * Convert SDK-provided custom tools into MCP tool definitions for a synthetic
5
+ * "custom-user-tools" server. The model discovers and invokes them through the
6
+ * same MCP meta-tool path as other servers (GetMcpTools / CallMcpTool). The
7
+ * map key is the tool name. The `name` field is the MCP wire identifier sent on
8
+ * AgentRunRequest; the model calls tools via GetMcpTools/CallMcpTool using
9
+ * server `custom-user-tools` and the bare `toolName`.
10
+ */
11
+ export declare function createCustomUserToolDefinitions(customTools: Record<string, SDKCustomTool> | undefined): NamedMcpToolDefinition[];
12
+ export declare function hasCustomTools(customTools: Record<string, SDKCustomTool> | undefined): customTools is Record<string, SDKCustomTool>;
13
+ /**
14
+ * True when an MCP invocation targets the synthetic SDK custom-tools server.
15
+ * Uses providerIdentifier only; wire names like `custom-user-tools-*` on other
16
+ * servers must still route through the lease-backed executor.
17
+ */
18
+ export declare function isSdkCustomUserToolsMcpCall(args: {
19
+ providerIdentifier: string;
20
+ name: string;
21
+ }): boolean;
22
+ /**
23
+ * Build the client-side MCP executor that handles calls to the synthetic
24
+ * "custom-user-tools" server by invoking the user's in-process callbacks. The
25
+ * agent loop (on the backend) calls `mcpExecutorResource.execute`, which
26
+ * round-trips to this implementation registered on the local runtime.
27
+ */
28
+ export declare function createSdkCustomToolMcpExecutor(customTools: Record<string, SDKCustomTool>): McpExecutor;
29
+ //# sourceMappingURL=custom-tools.d.ts.map