@opencode-ai/sdk 0.0.0-dev-202512080004 → 0.0.0-dev-202512080113

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.
@@ -27,19 +27,25 @@ declare class HeyApiRegistry<T> {
27
27
  }
28
28
  export declare class Global extends HeyApiClient {
29
29
  /**
30
- * Get events
30
+ * Get global events
31
+ *
32
+ * Subscribe to global events from the OpenCode system using server-sent events.
31
33
  */
32
34
  event<ThrowOnError extends boolean = false>(options?: Options<never, ThrowOnError>): Promise<import("./core/serverSentEvents.gen.js").ServerSentEventsResult<GlobalEventResponses, unknown>>;
33
35
  }
34
36
  export declare class Project extends HeyApiClient {
35
37
  /**
36
38
  * List all projects
39
+ *
40
+ * Get a list of projects that have been opened with OpenCode.
37
41
  */
38
42
  list<ThrowOnError extends boolean = false>(parameters?: {
39
43
  directory?: string;
40
44
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<ProjectListResponses, unknown, ThrowOnError, "fields">;
41
45
  /**
42
- * Get the current project
46
+ * Get current project
47
+ *
48
+ * Retrieve the currently active project that OpenCode is working with.
43
49
  */
44
50
  current<ThrowOnError extends boolean = false>(parameters?: {
45
51
  directory?: string;
@@ -47,13 +53,17 @@ export declare class Project extends HeyApiClient {
47
53
  }
48
54
  export declare class Pty extends HeyApiClient {
49
55
  /**
50
- * List all PTY sessions
56
+ * List PTY sessions
57
+ *
58
+ * Get a list of all active pseudo-terminal (PTY) sessions managed by OpenCode.
51
59
  */
52
60
  list<ThrowOnError extends boolean = false>(parameters?: {
53
61
  directory?: string;
54
62
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<PtyListResponses, unknown, ThrowOnError, "fields">;
55
63
  /**
56
- * Create a new PTY session
64
+ * Create PTY session
65
+ *
66
+ * Create a new pseudo-terminal (PTY) session for running shell commands and processes.
57
67
  */
58
68
  create<ThrowOnError extends boolean = false>(parameters?: {
59
69
  directory?: string;
@@ -66,14 +76,18 @@ export declare class Pty extends HeyApiClient {
66
76
  };
67
77
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<PtyCreateResponses, PtyCreateErrors, ThrowOnError, "fields">;
68
78
  /**
69
- * Remove a PTY session
79
+ * Remove PTY session
80
+ *
81
+ * Remove and terminate a specific pseudo-terminal (PTY) session.
70
82
  */
71
83
  remove<ThrowOnError extends boolean = false>(parameters: {
72
84
  ptyID: string;
73
85
  directory?: string;
74
86
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<PtyRemoveResponses, PtyRemoveErrors, ThrowOnError, "fields">;
75
87
  /**
76
- * Get PTY session info
88
+ * Get PTY session
89
+ *
90
+ * Retrieve detailed information about a specific pseudo-terminal (PTY) session.
77
91
  */
78
92
  get<ThrowOnError extends boolean = false>(parameters: {
79
93
  ptyID: string;
@@ -81,6 +95,8 @@ export declare class Pty extends HeyApiClient {
81
95
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<PtyGetResponses, PtyGetErrors, ThrowOnError, "fields">;
82
96
  /**
83
97
  * Update PTY session
98
+ *
99
+ * Update properties of an existing pseudo-terminal (PTY) session.
84
100
  */
85
101
  update<ThrowOnError extends boolean = false>(parameters: {
86
102
  ptyID: string;
@@ -92,7 +108,9 @@ export declare class Pty extends HeyApiClient {
92
108
  };
93
109
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<PtyUpdateResponses, PtyUpdateErrors, ThrowOnError, "fields">;
94
110
  /**
95
- * Connect to a PTY session
111
+ * Connect to PTY session
112
+ *
113
+ * Establish a WebSocket connection to interact with a pseudo-terminal (PTY) session in real-time.
96
114
  */
97
115
  connect<ThrowOnError extends boolean = false>(parameters: {
98
116
  ptyID: string;
@@ -101,20 +119,26 @@ export declare class Pty extends HeyApiClient {
101
119
  }
102
120
  export declare class Config extends HeyApiClient {
103
121
  /**
104
- * Get config info
122
+ * Get configuration
123
+ *
124
+ * Retrieve the current OpenCode configuration settings and preferences.
105
125
  */
106
126
  get<ThrowOnError extends boolean = false>(parameters?: {
107
127
  directory?: string;
108
128
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<ConfigGetResponses, unknown, ThrowOnError, "fields">;
109
129
  /**
110
- * Update config
130
+ * Update configuration
131
+ *
132
+ * Update OpenCode configuration settings and preferences.
111
133
  */
112
134
  update<ThrowOnError extends boolean = false>(parameters?: {
113
135
  directory?: string;
114
136
  config?: Config2;
115
137
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<ConfigUpdateResponses, ConfigUpdateErrors, ThrowOnError, "fields">;
116
138
  /**
117
- * List all providers
139
+ * List config providers
140
+ *
141
+ * Get a list of all configured AI providers and their default models.
118
142
  */
119
143
  providers<ThrowOnError extends boolean = false>(parameters?: {
120
144
  directory?: string;
@@ -122,13 +146,17 @@ export declare class Config extends HeyApiClient {
122
146
  }
123
147
  export declare class Tool extends HeyApiClient {
124
148
  /**
125
- * List all tool IDs (including built-in and dynamically registered)
149
+ * List tool IDs
150
+ *
151
+ * Get a list of all available tool IDs, including both built-in tools and dynamically registered tools.
126
152
  */
127
153
  ids<ThrowOnError extends boolean = false>(parameters?: {
128
154
  directory?: string;
129
155
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<ToolIdsResponses, ToolIdsErrors, ThrowOnError, "fields">;
130
156
  /**
131
- * List tools with JSON schema parameters for a provider/model
157
+ * List tools
158
+ *
159
+ * Get a list of available tools with their JSON schema parameters for a specific provider and model combination.
132
160
  */
133
161
  list<ThrowOnError extends boolean = false>(parameters: {
134
162
  directory?: string;
@@ -138,7 +166,9 @@ export declare class Tool extends HeyApiClient {
138
166
  }
139
167
  export declare class Instance extends HeyApiClient {
140
168
  /**
141
- * Dispose the current instance
169
+ * Dispose instance
170
+ *
171
+ * Clean up and dispose the current OpenCode instance, releasing all resources.
142
172
  */
143
173
  dispose<ThrowOnError extends boolean = false>(parameters?: {
144
174
  directory?: string;
@@ -146,7 +176,9 @@ export declare class Instance extends HeyApiClient {
146
176
  }
147
177
  export declare class Path extends HeyApiClient {
148
178
  /**
149
- * Get the current path
179
+ * Get paths
180
+ *
181
+ * Retrieve the current working directory and related path information for the OpenCode instance.
150
182
  */
151
183
  get<ThrowOnError extends boolean = false>(parameters?: {
152
184
  directory?: string;
@@ -154,7 +186,9 @@ export declare class Path extends HeyApiClient {
154
186
  }
155
187
  export declare class Vcs extends HeyApiClient {
156
188
  /**
157
- * Get VCS info for the current instance
189
+ * Get VCS info
190
+ *
191
+ * Retrieve version control system (VCS) information for the current project, such as git branch.
158
192
  */
159
193
  get<ThrowOnError extends boolean = false>(parameters?: {
160
194
  directory?: string;
@@ -162,13 +196,17 @@ export declare class Vcs extends HeyApiClient {
162
196
  }
163
197
  export declare class Session extends HeyApiClient {
164
198
  /**
165
- * List all sessions
199
+ * List sessions
200
+ *
201
+ * Get a list of all OpenCode sessions, sorted by most recently updated.
166
202
  */
167
203
  list<ThrowOnError extends boolean = false>(parameters?: {
168
204
  directory?: string;
169
205
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<SessionListResponses, unknown, ThrowOnError, "fields">;
170
206
  /**
171
- * Create a new session
207
+ * Create session
208
+ *
209
+ * Create a new OpenCode session for interacting with AI assistants and managing conversations.
172
210
  */
173
211
  create<ThrowOnError extends boolean = false>(parameters?: {
174
212
  directory?: string;
@@ -177,12 +215,16 @@ export declare class Session extends HeyApiClient {
177
215
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<SessionCreateResponses, SessionCreateErrors, ThrowOnError, "fields">;
178
216
  /**
179
217
  * Get session status
218
+ *
219
+ * Retrieve the current status of all sessions, including active, idle, and completed states.
180
220
  */
181
221
  status<ThrowOnError extends boolean = false>(parameters?: {
182
222
  directory?: string;
183
223
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<SessionStatusResponses, SessionStatusErrors, ThrowOnError, "fields">;
184
224
  /**
185
- * Delete a session and all its data
225
+ * Delete session
226
+ *
227
+ * Delete a session and permanently remove all associated data, including messages and history.
186
228
  */
187
229
  delete<ThrowOnError extends boolean = false>(parameters: {
188
230
  sessionID: string;
@@ -190,13 +232,17 @@ export declare class Session extends HeyApiClient {
190
232
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<SessionDeleteResponses, SessionDeleteErrors, ThrowOnError, "fields">;
191
233
  /**
192
234
  * Get session
235
+ *
236
+ * Retrieve detailed information about a specific OpenCode session.
193
237
  */
194
238
  get<ThrowOnError extends boolean = false>(parameters: {
195
239
  sessionID: string;
196
240
  directory?: string;
197
241
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<SessionGetResponses, SessionGetErrors, ThrowOnError, "fields">;
198
242
  /**
199
- * Update session properties
243
+ * Update session
244
+ *
245
+ * Update properties of an existing session, such as title or other metadata.
200
246
  */
201
247
  update<ThrowOnError extends boolean = false>(parameters: {
202
248
  sessionID: string;
@@ -204,21 +250,27 @@ export declare class Session extends HeyApiClient {
204
250
  title?: string;
205
251
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<SessionUpdateResponses, SessionUpdateErrors, ThrowOnError, "fields">;
206
252
  /**
207
- * Get a session's children
253
+ * Get session children
254
+ *
255
+ * Retrieve all child sessions that were forked from the specified parent session.
208
256
  */
209
257
  children<ThrowOnError extends boolean = false>(parameters: {
210
258
  sessionID: string;
211
259
  directory?: string;
212
260
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<SessionChildrenResponses, SessionChildrenErrors, ThrowOnError, "fields">;
213
261
  /**
214
- * Get the todo list for a session
262
+ * Get session todos
263
+ *
264
+ * Retrieve the todo list associated with a specific session, showing tasks and action items.
215
265
  */
216
266
  todo<ThrowOnError extends boolean = false>(parameters: {
217
267
  sessionID: string;
218
268
  directory?: string;
219
269
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<SessionTodoResponses, SessionTodoErrors, ThrowOnError, "fields">;
220
270
  /**
221
- * Analyze the app and create an AGENTS.md file
271
+ * Initialize session
272
+ *
273
+ * Analyze the current application and create an AGENTS.md file with project-specific agent configurations.
222
274
  */
223
275
  init<ThrowOnError extends boolean = false>(parameters: {
224
276
  sessionID: string;
@@ -228,7 +280,9 @@ export declare class Session extends HeyApiClient {
228
280
  messageID?: string;
229
281
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<SessionInitResponses, SessionInitErrors, ThrowOnError, "fields">;
230
282
  /**
231
- * Fork an existing session at a specific message
283
+ * Fork session
284
+ *
285
+ * Create a new session by forking an existing session at a specific message point.
232
286
  */
233
287
  fork<ThrowOnError extends boolean = false>(parameters: {
234
288
  sessionID: string;
@@ -236,28 +290,36 @@ export declare class Session extends HeyApiClient {
236
290
  messageID?: string;
237
291
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<SessionForkResponses, unknown, ThrowOnError, "fields">;
238
292
  /**
239
- * Abort a session
293
+ * Abort session
294
+ *
295
+ * Abort an active session and stop any ongoing AI processing or command execution.
240
296
  */
241
297
  abort<ThrowOnError extends boolean = false>(parameters: {
242
298
  sessionID: string;
243
299
  directory?: string;
244
300
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<SessionAbortResponses, SessionAbortErrors, ThrowOnError, "fields">;
245
301
  /**
246
- * Unshare the session
302
+ * Unshare session
303
+ *
304
+ * Remove the shareable link for a session, making it private again.
247
305
  */
248
306
  unshare<ThrowOnError extends boolean = false>(parameters: {
249
307
  sessionID: string;
250
308
  directory?: string;
251
309
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<SessionUnshareResponses, SessionUnshareErrors, ThrowOnError, "fields">;
252
310
  /**
253
- * Share a session
311
+ * Share session
312
+ *
313
+ * Create a shareable link for a session, allowing others to view the conversation.
254
314
  */
255
315
  share<ThrowOnError extends boolean = false>(parameters: {
256
316
  sessionID: string;
257
317
  directory?: string;
258
318
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<SessionShareResponses, SessionShareErrors, ThrowOnError, "fields">;
259
319
  /**
260
- * Get the diff for this session
320
+ * Get session diff
321
+ *
322
+ * Get all file changes (diffs) made during this session.
261
323
  */
262
324
  diff<ThrowOnError extends boolean = false>(parameters: {
263
325
  sessionID: string;
@@ -265,7 +327,9 @@ export declare class Session extends HeyApiClient {
265
327
  messageID?: string;
266
328
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<SessionDiffResponses, SessionDiffErrors, ThrowOnError, "fields">;
267
329
  /**
268
- * Summarize the session
330
+ * Summarize session
331
+ *
332
+ * Generate a concise summary of the session using AI compaction to preserve key information.
269
333
  */
270
334
  summarize<ThrowOnError extends boolean = false>(parameters: {
271
335
  sessionID: string;
@@ -274,7 +338,9 @@ export declare class Session extends HeyApiClient {
274
338
  modelID?: string;
275
339
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<SessionSummarizeResponses, SessionSummarizeErrors, ThrowOnError, "fields">;
276
340
  /**
277
- * List messages for a session
341
+ * Get session messages
342
+ *
343
+ * Retrieve all messages in a session, including user prompts and AI responses.
278
344
  */
279
345
  messages<ThrowOnError extends boolean = false>(parameters: {
280
346
  sessionID: string;
@@ -282,7 +348,9 @@ export declare class Session extends HeyApiClient {
282
348
  limit?: number;
283
349
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<SessionMessagesResponses, SessionMessagesErrors, ThrowOnError, "fields">;
284
350
  /**
285
- * Create and send a new message to a session
351
+ * Send message
352
+ *
353
+ * Create and send a new message to a session, streaming the AI response.
286
354
  */
287
355
  prompt<ThrowOnError extends boolean = false>(parameters: {
288
356
  sessionID: string;
@@ -301,7 +369,9 @@ export declare class Session extends HeyApiClient {
301
369
  parts?: Array<TextPartInput | FilePartInput | AgentPartInput | SubtaskPartInput>;
302
370
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<SessionPromptResponses, SessionPromptErrors, ThrowOnError, "fields">;
303
371
  /**
304
- * Get a message from a session
372
+ * Get message
373
+ *
374
+ * Retrieve a specific message from a session by its message ID.
305
375
  */
306
376
  message<ThrowOnError extends boolean = false>(parameters: {
307
377
  sessionID: string;
@@ -309,7 +379,9 @@ export declare class Session extends HeyApiClient {
309
379
  directory?: string;
310
380
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<SessionMessageResponses, SessionMessageErrors, ThrowOnError, "fields">;
311
381
  /**
312
- * Create and send a new message to a session, start if needed and return immediately
382
+ * Send async message
383
+ *
384
+ * Create and send a new message to a session asynchronously, starting the session if needed and returning immediately.
313
385
  */
314
386
  promptAsync<ThrowOnError extends boolean = false>(parameters: {
315
387
  sessionID: string;
@@ -328,7 +400,9 @@ export declare class Session extends HeyApiClient {
328
400
  parts?: Array<TextPartInput | FilePartInput | AgentPartInput | SubtaskPartInput>;
329
401
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<SessionPromptAsyncResponses, SessionPromptAsyncErrors, ThrowOnError, "fields">;
330
402
  /**
331
- * Send a new command to a session
403
+ * Send command
404
+ *
405
+ * Send a new command to a session for execution by the AI assistant.
332
406
  */
333
407
  command<ThrowOnError extends boolean = false>(parameters: {
334
408
  sessionID: string;
@@ -340,7 +414,9 @@ export declare class Session extends HeyApiClient {
340
414
  command?: string;
341
415
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<SessionCommandResponses, SessionCommandErrors, ThrowOnError, "fields">;
342
416
  /**
343
- * Run a shell command
417
+ * Run shell command
418
+ *
419
+ * Execute a shell command within the session context and return the AI's response.
344
420
  */
345
421
  shell<ThrowOnError extends boolean = false>(parameters: {
346
422
  sessionID: string;
@@ -353,7 +429,9 @@ export declare class Session extends HeyApiClient {
353
429
  command?: string;
354
430
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<SessionShellResponses, SessionShellErrors, ThrowOnError, "fields">;
355
431
  /**
356
- * Revert a message
432
+ * Revert message
433
+ *
434
+ * Revert a specific message in a session, undoing its effects and restoring the previous state.
357
435
  */
358
436
  revert<ThrowOnError extends boolean = false>(parameters: {
359
437
  sessionID: string;
@@ -362,7 +440,9 @@ export declare class Session extends HeyApiClient {
362
440
  partID?: string;
363
441
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<SessionRevertResponses, SessionRevertErrors, ThrowOnError, "fields">;
364
442
  /**
365
- * Restore all reverted messages
443
+ * Restore reverted messages
444
+ *
445
+ * Restore all previously reverted messages in a session.
366
446
  */
367
447
  unrevert<ThrowOnError extends boolean = false>(parameters: {
368
448
  sessionID: string;
@@ -371,7 +451,9 @@ export declare class Session extends HeyApiClient {
371
451
  }
372
452
  export declare class Permission extends HeyApiClient {
373
453
  /**
374
- * Respond to a permission request
454
+ * Respond to permission
455
+ *
456
+ * Approve or deny a permission request from the AI assistant.
375
457
  */
376
458
  respond<ThrowOnError extends boolean = false>(parameters: {
377
459
  sessionID: string;
@@ -382,7 +464,9 @@ export declare class Permission extends HeyApiClient {
382
464
  }
383
465
  export declare class Command extends HeyApiClient {
384
466
  /**
385
- * List all commands
467
+ * List commands
468
+ *
469
+ * Get a list of all available commands in the OpenCode system.
386
470
  */
387
471
  list<ThrowOnError extends boolean = false>(parameters?: {
388
472
  directory?: string;
@@ -390,7 +474,9 @@ export declare class Command extends HeyApiClient {
390
474
  }
391
475
  export declare class Oauth extends HeyApiClient {
392
476
  /**
393
- * Authorize a provider using OAuth
477
+ * OAuth authorize
478
+ *
479
+ * Initiate OAuth authorization for a specific AI provider to get an authorization URL.
394
480
  */
395
481
  authorize<ThrowOnError extends boolean = false>(parameters: {
396
482
  providerID: string;
@@ -398,7 +484,9 @@ export declare class Oauth extends HeyApiClient {
398
484
  method?: number;
399
485
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<ProviderOauthAuthorizeResponses, ProviderOauthAuthorizeErrors, ThrowOnError, "fields">;
400
486
  /**
401
- * Handle OAuth callback for a provider
487
+ * OAuth callback
488
+ *
489
+ * Handle the OAuth callback from a provider after user authorization.
402
490
  */
403
491
  callback<ThrowOnError extends boolean = false>(parameters: {
404
492
  providerID: string;
@@ -409,13 +497,17 @@ export declare class Oauth extends HeyApiClient {
409
497
  }
410
498
  export declare class Provider extends HeyApiClient {
411
499
  /**
412
- * List all providers
500
+ * List providers
501
+ *
502
+ * Get a list of all available AI providers, including both available and connected ones.
413
503
  */
414
504
  list<ThrowOnError extends boolean = false>(parameters?: {
415
505
  directory?: string;
416
506
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<ProviderListResponses, unknown, ThrowOnError, "fields">;
417
507
  /**
418
- * Get provider authentication methods
508
+ * Get provider auth methods
509
+ *
510
+ * Retrieve available authentication methods for all AI providers.
419
511
  */
420
512
  auth<ThrowOnError extends boolean = false>(parameters?: {
421
513
  directory?: string;
@@ -424,7 +516,9 @@ export declare class Provider extends HeyApiClient {
424
516
  }
425
517
  export declare class Find extends HeyApiClient {
426
518
  /**
427
- * Find text in files
519
+ * Find text
520
+ *
521
+ * Search for text patterns across files in the project using ripgrep.
428
522
  */
429
523
  text<ThrowOnError extends boolean = false>(parameters: {
430
524
  directory?: string;
@@ -432,6 +526,8 @@ export declare class Find extends HeyApiClient {
432
526
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<FindTextResponses, unknown, ThrowOnError, "fields">;
433
527
  /**
434
528
  * Find files
529
+ *
530
+ * Search for files by name or pattern in the project directory.
435
531
  */
436
532
  files<ThrowOnError extends boolean = false>(parameters: {
437
533
  directory?: string;
@@ -439,7 +535,9 @@ export declare class Find extends HeyApiClient {
439
535
  dirs?: "true" | "false";
440
536
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<FindFilesResponses, unknown, ThrowOnError, "fields">;
441
537
  /**
442
- * Find workspace symbols
538
+ * Find symbols
539
+ *
540
+ * Search for workspace symbols like functions, classes, and variables using LSP.
443
541
  */
444
542
  symbols<ThrowOnError extends boolean = false>(parameters: {
445
543
  directory?: string;
@@ -448,14 +546,18 @@ export declare class Find extends HeyApiClient {
448
546
  }
449
547
  export declare class File extends HeyApiClient {
450
548
  /**
451
- * List files and directories
549
+ * List files
550
+ *
551
+ * List files and directories in a specified path.
452
552
  */
453
553
  list<ThrowOnError extends boolean = false>(parameters: {
454
554
  directory?: string;
455
555
  path: string;
456
556
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<FileListResponses, unknown, ThrowOnError, "fields">;
457
557
  /**
458
- * Read a file
558
+ * Read file
559
+ *
560
+ * Read the content of a specified file.
459
561
  */
460
562
  read<ThrowOnError extends boolean = false>(parameters: {
461
563
  directory?: string;
@@ -463,6 +565,8 @@ export declare class File extends HeyApiClient {
463
565
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<FileReadResponses, unknown, ThrowOnError, "fields">;
464
566
  /**
465
567
  * Get file status
568
+ *
569
+ * Get the git status of all files in the project.
466
570
  */
467
571
  status<ThrowOnError extends boolean = false>(parameters?: {
468
572
  directory?: string;
@@ -470,7 +574,9 @@ export declare class File extends HeyApiClient {
470
574
  }
471
575
  export declare class App extends HeyApiClient {
472
576
  /**
473
- * Write a log entry to the server logs
577
+ * Write log
578
+ *
579
+ * Write a log entry to the server logs with specified level and metadata.
474
580
  */
475
581
  log<ThrowOnError extends boolean = false>(parameters?: {
476
582
  directory?: string;
@@ -482,7 +588,9 @@ export declare class App extends HeyApiClient {
482
588
  };
483
589
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<AppLogResponses, AppLogErrors, ThrowOnError, "fields">;
484
590
  /**
485
- * List all agents
591
+ * List agents
592
+ *
593
+ * Get a list of all available AI agents in the OpenCode system.
486
594
  */
487
595
  agents<ThrowOnError extends boolean = false>(parameters?: {
488
596
  directory?: string;
@@ -490,6 +598,8 @@ export declare class App extends HeyApiClient {
490
598
  }
491
599
  export declare class Auth extends HeyApiClient {
492
600
  /**
601
+ * Remove MCP OAuth
602
+ *
493
603
  * Remove OAuth credentials for an MCP server
494
604
  */
495
605
  remove<ThrowOnError extends boolean = false>(parameters: {
@@ -497,14 +607,18 @@ export declare class Auth extends HeyApiClient {
497
607
  directory?: string;
498
608
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<McpAuthRemoveResponses, McpAuthRemoveErrors, ThrowOnError, "fields">;
499
609
  /**
500
- * Start OAuth authentication flow for an MCP server
610
+ * Start MCP OAuth
611
+ *
612
+ * Start OAuth authentication flow for a Model Context Protocol (MCP) server.
501
613
  */
502
614
  start<ThrowOnError extends boolean = false>(parameters: {
503
615
  name: string;
504
616
  directory?: string;
505
617
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<McpAuthStartResponses, McpAuthStartErrors, ThrowOnError, "fields">;
506
618
  /**
507
- * Complete OAuth authentication with authorization code
619
+ * Complete MCP OAuth
620
+ *
621
+ * Complete OAuth authentication for a Model Context Protocol (MCP) server using the authorization code.
508
622
  */
509
623
  callback<ThrowOnError extends boolean = false>(parameters: {
510
624
  name: string;
@@ -512,6 +626,8 @@ export declare class Auth extends HeyApiClient {
512
626
  code?: string;
513
627
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<McpAuthCallbackResponses, McpAuthCallbackErrors, ThrowOnError, "fields">;
514
628
  /**
629
+ * Authenticate MCP OAuth
630
+ *
515
631
  * Start OAuth flow and wait for callback (opens browser)
516
632
  */
517
633
  authenticate<ThrowOnError extends boolean = false>(parameters: {
@@ -519,6 +635,8 @@ export declare class Auth extends HeyApiClient {
519
635
  directory?: string;
520
636
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<McpAuthAuthenticateResponses, McpAuthAuthenticateErrors, ThrowOnError, "fields">;
521
637
  /**
638
+ * Set auth credentials
639
+ *
522
640
  * Set authentication credentials
523
641
  */
524
642
  set<ThrowOnError extends boolean = false>(parameters: {
@@ -529,13 +647,17 @@ export declare class Auth extends HeyApiClient {
529
647
  }
530
648
  export declare class Mcp extends HeyApiClient {
531
649
  /**
532
- * Get MCP server status
650
+ * Get MCP status
651
+ *
652
+ * Get the status of all Model Context Protocol (MCP) servers.
533
653
  */
534
654
  status<ThrowOnError extends boolean = false>(parameters?: {
535
655
  directory?: string;
536
656
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<McpStatusResponses, unknown, ThrowOnError, "fields">;
537
657
  /**
538
- * Add MCP server dynamically
658
+ * Add MCP server
659
+ *
660
+ * Dynamically add a new Model Context Protocol (MCP) server to the system.
539
661
  */
540
662
  add<ThrowOnError extends boolean = false>(parameters?: {
541
663
  directory?: string;
@@ -546,6 +668,8 @@ export declare class Mcp extends HeyApiClient {
546
668
  }
547
669
  export declare class Lsp extends HeyApiClient {
548
670
  /**
671
+ * Get LSP status
672
+ *
549
673
  * Get LSP server status
550
674
  */
551
675
  status<ThrowOnError extends boolean = false>(parameters?: {
@@ -554,6 +678,8 @@ export declare class Lsp extends HeyApiClient {
554
678
  }
555
679
  export declare class Formatter extends HeyApiClient {
556
680
  /**
681
+ * Get formatter status
682
+ *
557
683
  * Get formatter status
558
684
  */
559
685
  status<ThrowOnError extends boolean = false>(parameters?: {
@@ -562,13 +688,17 @@ export declare class Formatter extends HeyApiClient {
562
688
  }
563
689
  export declare class Control extends HeyApiClient {
564
690
  /**
565
- * Get the next TUI request from the queue
691
+ * Get next TUI request
692
+ *
693
+ * Retrieve the next TUI (Terminal User Interface) request from the queue for processing.
566
694
  */
567
695
  next<ThrowOnError extends boolean = false>(parameters?: {
568
696
  directory?: string;
569
697
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<TuiControlNextResponses, unknown, ThrowOnError, "fields">;
570
698
  /**
571
- * Submit a response to the TUI request queue
699
+ * Submit TUI response
700
+ *
701
+ * Submit a response to the TUI request queue to complete a pending request.
572
702
  */
573
703
  response<ThrowOnError extends boolean = false>(parameters?: {
574
704
  directory?: string;
@@ -577,6 +707,8 @@ export declare class Control extends HeyApiClient {
577
707
  }
578
708
  export declare class Tui extends HeyApiClient {
579
709
  /**
710
+ * Append TUI prompt
711
+ *
580
712
  * Append prompt to the TUI
581
713
  */
582
714
  appendPrompt<ThrowOnError extends boolean = false>(parameters?: {
@@ -584,42 +716,56 @@ export declare class Tui extends HeyApiClient {
584
716
  text?: string;
585
717
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<TuiAppendPromptResponses, TuiAppendPromptErrors, ThrowOnError, "fields">;
586
718
  /**
587
- * Open the help dialog
719
+ * Open help dialog
720
+ *
721
+ * Open the help dialog in the TUI to display user assistance information.
588
722
  */
589
723
  openHelp<ThrowOnError extends boolean = false>(parameters?: {
590
724
  directory?: string;
591
725
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<TuiOpenHelpResponses, unknown, ThrowOnError, "fields">;
592
726
  /**
727
+ * Open sessions dialog
728
+ *
593
729
  * Open the session dialog
594
730
  */
595
731
  openSessions<ThrowOnError extends boolean = false>(parameters?: {
596
732
  directory?: string;
597
733
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<TuiOpenSessionsResponses, unknown, ThrowOnError, "fields">;
598
734
  /**
735
+ * Open themes dialog
736
+ *
599
737
  * Open the theme dialog
600
738
  */
601
739
  openThemes<ThrowOnError extends boolean = false>(parameters?: {
602
740
  directory?: string;
603
741
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<TuiOpenThemesResponses, unknown, ThrowOnError, "fields">;
604
742
  /**
743
+ * Open models dialog
744
+ *
605
745
  * Open the model dialog
606
746
  */
607
747
  openModels<ThrowOnError extends boolean = false>(parameters?: {
608
748
  directory?: string;
609
749
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<TuiOpenModelsResponses, unknown, ThrowOnError, "fields">;
610
750
  /**
751
+ * Submit TUI prompt
752
+ *
611
753
  * Submit the prompt
612
754
  */
613
755
  submitPrompt<ThrowOnError extends boolean = false>(parameters?: {
614
756
  directory?: string;
615
757
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<TuiSubmitPromptResponses, unknown, ThrowOnError, "fields">;
616
758
  /**
759
+ * Clear TUI prompt
760
+ *
617
761
  * Clear the prompt
618
762
  */
619
763
  clearPrompt<ThrowOnError extends boolean = false>(parameters?: {
620
764
  directory?: string;
621
765
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<TuiClearPromptResponses, unknown, ThrowOnError, "fields">;
622
766
  /**
767
+ * Execute TUI command
768
+ *
623
769
  * Execute a TUI command (e.g. agent_cycle)
624
770
  */
625
771
  executeCommand<ThrowOnError extends boolean = false>(parameters?: {
@@ -627,6 +773,8 @@ export declare class Tui extends HeyApiClient {
627
773
  command?: string;
628
774
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<TuiExecuteCommandResponses, TuiExecuteCommandErrors, ThrowOnError, "fields">;
629
775
  /**
776
+ * Show TUI toast
777
+ *
630
778
  * Show a toast notification in the TUI
631
779
  */
632
780
  showToast<ThrowOnError extends boolean = false>(parameters?: {
@@ -637,6 +785,8 @@ export declare class Tui extends HeyApiClient {
637
785
  duration?: number;
638
786
  }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<TuiShowToastResponses, unknown, ThrowOnError, "fields">;
639
787
  /**
788
+ * Publish TUI event
789
+ *
640
790
  * Publish a TUI event
641
791
  */
642
792
  publish<ThrowOnError extends boolean = false>(parameters?: {
@@ -647,6 +797,8 @@ export declare class Tui extends HeyApiClient {
647
797
  }
648
798
  export declare class Event extends HeyApiClient {
649
799
  /**
800
+ * Subscribe to events
801
+ *
650
802
  * Get events
651
803
  */
652
804
  subscribe<ThrowOnError extends boolean = false>(parameters?: {