@opencode-ai/sdk 0.1.0-alpha.2 → 0.1.0-alpha.20

package/src/client.ts

@@ -16,48 +16,74 @@ import * as Errors from './core/error';
 import * as Uploads from './core/uploads';
 import * as API from './resources/index';
 import { APIPromise } from './core/api-promise';
-import { AppInfo, AppInfoCreateResponse } from './resources/app-info';
-import { AppInitialize, AppInitializeInitializeResponse } from './resources/app-initialize';
-import { ConfigGet, ConfigGetRetrieveResponse } from './resources/config-get';
-import { Event, EventListResponse } from './resources/event';
-import { FileSearch, FileSearchSearchParams, FileSearchSearchResponse } from './resources/file-search';
-import { InstallationInfo, InstallationInfoCreateResponse } from './resources/installation-info';
-import { PathGet, PathGetCreateResponse } from './resources/path-get';
-import { ProviderList, ProviderListCreateResponse } from './resources/provider-list';
-import { SessionAbort, SessionAbortAbortParams, SessionAbortAbortResponse } from './resources/session-abort';
 import {
-  MessageInfo,
-  MessagePart,
-  ProviderAuthError,
-  SessionChat,
-  SessionChatCreateParams,
-  UnknownError,
-} from './resources/session-chat';
-import { SessionCreate, SessionInfo } from './resources/session-create';
+  App,
+  AppInitResponse,
+  AppLogParams,
+  AppLogResponse,
+  AppModesResponse,
+  AppProvidersResponse,
+  AppResource,
+  LogLevel,
+  Mode,
+  Model,
+  Provider,
+} from './resources/app';
 import {
-  SessionInitialize,
-  SessionInitializeCreateParams,
-  SessionInitializeCreateResponse,
-} from './resources/session-initialize';
-import { SessionList, SessionListCreateResponse } from './resources/session-list';
+  Config,
+  ConfigResource,
+  KeybindsConfig,
+  LayoutConfig,
+  McpLocalConfig,
+  McpRemoteConfig,
+  ModeConfig,
+} from './resources/config';
+import { Event, EventListResponse } from './resources/event';
+import { File, FileReadParams, FileReadResponse, FileResource, FileStatusResponse } from './resources/file';
 import {
-  SessionMessageCreateParams,
-  SessionMessageCreateResponse,
-  SessionMessages,
-} from './resources/session-messages';
-import { SessionShare, SessionShareCreateParams } from './resources/session-share';
+  Find,
+  FindFilesParams,
+  FindFilesResponse,
+  FindSymbolsParams,
+  FindSymbolsResponse,
+  FindTextParams,
+  FindTextResponse,
+  Match,
+  Symbol,
+} from './resources/find';
 import {
-  SessionSummarize,
-  SessionSummarizeSummarizeParams,
-  SessionSummarizeSummarizeResponse,
-} from './resources/session-summarize';
-import { SessionUnshare, SessionUnshareUnshareParams } from './resources/session-unshare';
+  AssistantMessage,
+  FilePart,
+  Message,
+  Part,
+  Session,
+  SessionAbortResponse,
+  SessionChatParams,
+  SessionDeleteResponse,
+  SessionInitParams,
+  SessionInitResponse,
+  SessionListResponse,
+  SessionMessagesResponse,
+  SessionResource,
+  SessionSummarizeParams,
+  SessionSummarizeResponse,
+  SnapshotPart,
+  StepFinishPart,
+  StepStartPart,
+  TextPart,
+  ToolPart,
+  ToolStateCompleted,
+  ToolStateError,
+  ToolStatePending,
+  ToolStateRunning,
+  UserMessage,
+} from './resources/session';
 import { type Fetch } from './internal/builtin-types';
 import { HeadersLike, NullableHeaders, buildHeaders } from './internal/headers';
 import { FinalRequestOptions, RequestOptions } from './internal/request-options';
 import { readEnv } from './internal/utils/env';
 import {
-  type LogLevel,
+  type LogLevel as ClientLogLevel,
   type Logger,
   formatRequestDetails,
   loggerFor,
@@ -79,6 +105,8 @@ export interface ClientOptions {
    *
    * Note that request timeouts are retried by default, so in a worst-case scenario you may wait
    * much longer than this timeout before the promise succeeds or fails.
+   *
+   * @unit milliseconds
    */
   timeout?: number | undefined;
   /**
@@ -123,7 +151,7 @@ export interface ClientOptions {
    *
    * Defaults to process.env['OPENCODE_LOG'] or 'warn' if it isn't set.
    */
-  logLevel?: LogLevel | undefined;
+  logLevel?: ClientLogLevel | undefined;
 
   /**
    * Set the logger.
@@ -141,7 +169,7 @@ export class Opencode {
   maxRetries: number;
   timeout: number;
   logger: Logger | undefined;
-  logLevel: LogLevel | undefined;
+  logLevel: ClientLogLevel | undefined;
   fetchOptions: MergedRequestInit | undefined;
 
   private fetch: Fetch;
@@ -188,7 +216,7 @@ export class Opencode {
    * Create a new client instance re-using the same options given to the current client with optional overriding.
    */
   withOptions(options: Partial<ClientOptions>): this {
-    return new (this.constructor as any as new (props: ClientOptions) => typeof this)({
+    const client = new (this.constructor as any as new (props: ClientOptions) => typeof this)({
       ...this._options,
       baseURL: this.baseURL,
       maxRetries: this.maxRetries,
@@ -199,6 +227,7 @@ export class Opencode {
       fetchOptions: this.fetchOptions,
       ...options,
     });
+    return client;
   }
 
   /**
@@ -344,7 +373,9 @@ export class Opencode {
 
     await this.prepareOptions(options);
 
-    const { req, url, timeout } = this.buildRequest(options, { retryCount: maxRetries - retriesRemaining });
+    const { req, url, timeout } = await this.buildRequest(options, {
+      retryCount: maxRetries - retriesRemaining,
+    });
 
     await this.prepareRequest(req, { url, options });
 
@@ -422,7 +453,7 @@ export class Opencode {
     } with status ${response.status} in ${headersTime - startTime}ms`;
 
     if (!response.ok) {
-      const shouldRetry = this.shouldRetry(response);
+      const shouldRetry = await this.shouldRetry(response);
       if (retriesRemaining && shouldRetry) {
         const retryMessage = `retrying, ${retriesRemaining} attempts remaining`;
 
@@ -521,7 +552,7 @@ export class Opencode {
     }
   }
 
-  private shouldRetry(response: Response): boolean {
+  private async shouldRetry(response: Response): Promise<boolean> {
     // Note this is not a standard header.
     const shouldRetryHeader = response.headers.get('x-should-retry');
 
@@ -598,10 +629,10 @@ export class Opencode {
     return sleepSeconds * jitter * 1000;
   }
 
-  buildRequest(
+  async buildRequest(
     inputOptions: FinalRequestOptions,
     { retryCount = 0 }: { retryCount?: number } = {},
-  ): { req: FinalizedRequestInit; url: string; timeout: number } {
+  ): Promise<{ req: FinalizedRequestInit; url: string; timeout: number }> {
     const options = { ...inputOptions };
     const { method, path, query, defaultBaseURL } = options;
 
@@ -609,7 +640,7 @@ export class Opencode {
     if ('timeout' in options) validatePositiveInteger('timeout', options.timeout);
     options.timeout = options.timeout ?? this.timeout;
     const { bodyHeaders, body } = this.buildBody({ options });
-    const reqHeaders = this.buildHeaders({ options: inputOptions, method, bodyHeaders, retryCount });
+    const reqHeaders = await this.buildHeaders({ options: inputOptions, method, bodyHeaders, retryCount });
 
     const req: FinalizedRequestInit = {
       method,
@@ -625,7 +656,7 @@ export class Opencode {
     return { req, url, timeout: options.timeout };
   }
 
-  private buildHeaders({
+  private async buildHeaders({
     options,
     method,
     bodyHeaders,
@@ -635,7 +666,7 @@ export class Opencode {
     method: HTTPMethod;
     bodyHeaders: HeadersLike;
     retryCount: number;
-  }): Headers {
+  }): Promise<Headers> {
     let idempotencyHeaders: HeadersLike = {};
     if (this.idempotencyHeader && method !== 'get') {
       if (!options.idempotencyKey) options.idempotencyKey = this.defaultIdempotencyKey();
@@ -718,110 +749,96 @@ export class Opencode {
   static toFile = Uploads.toFile;
 
   event: API.Event = new API.Event(this);
-  appInfo: API.AppInfo = new API.AppInfo(this);
-  configGet: API.ConfigGet = new API.ConfigGet(this);
-  appInitialize: API.AppInitialize = new API.AppInitialize(this);
-  sessionInitialize: API.SessionInitialize = new API.SessionInitialize(this);
-  pathGet: API.PathGet = new API.PathGet(this);
-  sessionCreate: API.SessionCreate = new API.SessionCreate(this);
-  sessionShare: API.SessionShare = new API.SessionShare(this);
-  sessionUnshare: API.SessionUnshare = new API.SessionUnshare(this);
-  sessionMessages: API.SessionMessages = new API.SessionMessages(this);
-  sessionList: API.SessionList = new API.SessionList(this);
-  sessionAbort: API.SessionAbort = new API.SessionAbort(this);
-  sessionSummarize: API.SessionSummarize = new API.SessionSummarize(this);
-  sessionChat: API.SessionChat = new API.SessionChat(this);
-  providerList: API.ProviderList = new API.ProviderList(this);
-  fileSearch: API.FileSearch = new API.FileSearch(this);
-  installationInfo: API.InstallationInfo = new API.InstallationInfo(this);
+  app: API.AppResource = new API.AppResource(this);
+  find: API.Find = new API.Find(this);
+  file: API.FileResource = new API.FileResource(this);
+  config: API.ConfigResource = new API.ConfigResource(this);
+  session: API.SessionResource = new API.SessionResource(this);
 }
 Opencode.Event = Event;
-Opencode.AppInfo = AppInfo;
-Opencode.ConfigGet = ConfigGet;
-Opencode.AppInitialize = AppInitialize;
-Opencode.SessionInitialize = SessionInitialize;
-Opencode.PathGet = PathGet;
-Opencode.SessionCreate = SessionCreate;
-Opencode.SessionShare = SessionShare;
-Opencode.SessionUnshare = SessionUnshare;
-Opencode.SessionMessages = SessionMessages;
-Opencode.SessionList = SessionList;
-Opencode.SessionAbort = SessionAbort;
-Opencode.SessionSummarize = SessionSummarize;
-Opencode.SessionChat = SessionChat;
-Opencode.ProviderList = ProviderList;
-Opencode.FileSearch = FileSearch;
-Opencode.InstallationInfo = InstallationInfo;
+Opencode.AppResource = AppResource;
+Opencode.Find = Find;
+Opencode.FileResource = FileResource;
+Opencode.ConfigResource = ConfigResource;
+Opencode.SessionResource = SessionResource;
 export declare namespace Opencode {
   export type RequestOptions = Opts.RequestOptions;
 
   export { Event as Event, type EventListResponse as EventListResponse };
 
-  export { AppInfo as AppInfo, type AppInfoCreateResponse as AppInfoCreateResponse };
-
-  export { ConfigGet as ConfigGet, type ConfigGetRetrieveResponse as ConfigGetRetrieveResponse };
-
-  export {
-    AppInitialize as AppInitialize,
-    type AppInitializeInitializeResponse as AppInitializeInitializeResponse,
-  };
-
-  export {
-    SessionInitialize as SessionInitialize,
-    type SessionInitializeCreateResponse as SessionInitializeCreateResponse,
-    type SessionInitializeCreateParams as SessionInitializeCreateParams,
-  };
-
-  export { PathGet as PathGet, type PathGetCreateResponse as PathGetCreateResponse };
-
-  export { SessionCreate as SessionCreate, type SessionInfo as SessionInfo };
-
-  export { SessionShare as SessionShare, type SessionShareCreateParams as SessionShareCreateParams };
-
   export {
-    SessionUnshare as SessionUnshare,
-    type SessionUnshareUnshareParams as SessionUnshareUnshareParams,
+    AppResource as AppResource,
+    type App as App,
+    type LogLevel as LogLevel,
+    type Mode as Mode,
+    type Model as Model,
+    type Provider as Provider,
+    type AppInitResponse as AppInitResponse,
+    type AppLogResponse as AppLogResponse,
+    type AppModesResponse as AppModesResponse,
+    type AppProvidersResponse as AppProvidersResponse,
+    type AppLogParams as AppLogParams,
   };
 
   export {
-    SessionMessages as SessionMessages,
-    type SessionMessageCreateResponse as SessionMessageCreateResponse,
-    type SessionMessageCreateParams as SessionMessageCreateParams,
+    Find as Find,
+    type Match as Match,
+    type Symbol as Symbol,
+    type FindFilesResponse as FindFilesResponse,
+    type FindSymbolsResponse as FindSymbolsResponse,
+    type FindTextResponse as FindTextResponse,
+    type FindFilesParams as FindFilesParams,
+    type FindSymbolsParams as FindSymbolsParams,
+    type FindTextParams as FindTextParams,
   };
 
-  export { SessionList as SessionList, type SessionListCreateResponse as SessionListCreateResponse };
-
   export {
-    SessionAbort as SessionAbort,
-    type SessionAbortAbortResponse as SessionAbortAbortResponse,
-    type SessionAbortAbortParams as SessionAbortAbortParams,
+    FileResource as FileResource,
+    type File as File,
+    type FileReadResponse as FileReadResponse,
+    type FileStatusResponse as FileStatusResponse,
+    type FileReadParams as FileReadParams,
   };
 
   export {
-    SessionSummarize as SessionSummarize,
-    type SessionSummarizeSummarizeResponse as SessionSummarizeSummarizeResponse,
-    type SessionSummarizeSummarizeParams as SessionSummarizeSummarizeParams,
+    ConfigResource as ConfigResource,
+    type Config as Config,
+    type KeybindsConfig as KeybindsConfig,
+    type LayoutConfig as LayoutConfig,
+    type McpLocalConfig as McpLocalConfig,
+    type McpRemoteConfig as McpRemoteConfig,
+    type ModeConfig as ModeConfig,
   };
 
   export {
-    SessionChat as SessionChat,
-    type MessageInfo as MessageInfo,
-    type MessagePart as MessagePart,
-    type ProviderAuthError as ProviderAuthError,
-    type UnknownError as UnknownError,
-    type SessionChatCreateParams as SessionChatCreateParams,
+    SessionResource as SessionResource,
+    type AssistantMessage as AssistantMessage,
+    type FilePart as FilePart,
+    type Message as Message,
+    type Part as Part,
+    type Session as Session,
+    type SnapshotPart as SnapshotPart,
+    type StepFinishPart as StepFinishPart,
+    type StepStartPart as StepStartPart,
+    type TextPart as TextPart,
+    type ToolPart as ToolPart,
+    type ToolStateCompleted as ToolStateCompleted,
+    type ToolStateError as ToolStateError,
+    type ToolStatePending as ToolStatePending,
+    type ToolStateRunning as ToolStateRunning,
+    type UserMessage as UserMessage,
+    type SessionListResponse as SessionListResponse,
+    type SessionDeleteResponse as SessionDeleteResponse,
+    type SessionAbortResponse as SessionAbortResponse,
+    type SessionInitResponse as SessionInitResponse,
+    type SessionMessagesResponse as SessionMessagesResponse,
+    type SessionSummarizeResponse as SessionSummarizeResponse,
+    type SessionChatParams as SessionChatParams,
+    type SessionInitParams as SessionInitParams,
+    type SessionSummarizeParams as SessionSummarizeParams,
   };
 
-  export { ProviderList as ProviderList, type ProviderListCreateResponse as ProviderListCreateResponse };
-
-  export {
-    FileSearch as FileSearch,
-    type FileSearchSearchResponse as FileSearchSearchResponse,
-    type FileSearchSearchParams as FileSearchSearchParams,
-  };
-
-  export {
-    InstallationInfo as InstallationInfo,
-    type InstallationInfoCreateResponse as InstallationInfoCreateResponse,
-  };
+  export type MessageAbortedError = API.MessageAbortedError;
+  export type ProviderAuthError = API.ProviderAuthError;
+  export type UnknownError = API.UnknownError;
 }