@gitterm/sdk 0.1.3 → 0.2.1

package/dist/client.d.ts

@@ -1,4 +1,5 @@
-import type { AgentType, AgentRun, AgentRunCreateInput, AgentRunListOptions, AgentRunListResult, AgentRunMessage, AgentRunReply, AuthStatus, CloudProvider, RunRef, RunWaitOptions, WaitOptions, Workspace, WorkspaceCreateInput, WorkspaceCreateResult, WorkspaceEnsureRunningResult, WorkspaceListOptions, WorkspaceListResult, WorkspaceRef, WorkspaceRestartResult, WorkspaceRuntimeAccess, WorkspacePauseResult, WorkspaceTerminateResult, WorkspaceCatalog, WorkspaceSetupStatus, ModelCredential, ModelProviderInfo } from "./types.js";
+import type { AgentType, AgentRun, AgentRunCreateInput, AgentRunListOptions, AgentRunListResult, AgentRunMessage, AgentRunReply, AuthStatus, CloudProvider, RunRef, RunWaitOptions, RunWatchOptions, WaitOptions, Workspace, WorkspaceCreateInput, WorkspaceCreateResult, WorkspaceEnsureRunningResult, WorkspaceListOptions, WorkspaceListResult, WorkspaceRef, WorkspaceRestartResult, WorkspaceRuntimeAccess, WorkspacePauseResult, WorkspaceTerminateResult, WorkspaceCatalog, WorkspaceSetupStatus, ModelCredential, ModelProviderInfo } from "./types.js";
+import type { AgentRunEvent, AgentRunResult, RunResultOptions, ModelInfo, WorkspaceModelAccess } from "./types.js";
 export type GittermClientOptions = {
     serverUrl?: string;
     token?: string;
@@ -21,32 +22,36 @@ export type GittermClient = {
         terminate(workspace: WorkspaceRef): Promise<WorkspaceTerminateResult>;
         create(input: WorkspaceCreateInput): Promise<WorkspaceCreateResult>;
         setupStatus(workspace: WorkspaceRef): Promise<WorkspaceSetupStatus>;
+        /** Credential-source metadata and known models; never wakes the runtime. */
+        models(workspace: WorkspaceRef): Promise<WorkspaceModelAccess>;
         waitForSetup(workspace: WorkspaceRef, options?: WaitOptions): Promise<WorkspaceSetupStatus>;
     };
     runs: {
         create(input: AgentRunCreateInput): Promise<AgentRun>;
         list(workspace: WorkspaceRef, options?: AgentRunListOptions): Promise<AgentRunListResult>;
         get(run: RunRef): Promise<AgentRun>;
-        get(workspaceId: string, runId: string): Promise<AgentRun>;
         messages(run: RunRef): Promise<AgentRunMessage[]>;
-        messages(workspaceId: string, runId: string): Promise<AgentRunMessage[]>;
         cancel(run: RunRef): Promise<{
             cancelled: boolean;
         }>;
-        cancel(workspaceId: string, runId: string): Promise<{
-            cancelled: boolean;
-        }>;
         /** Answer the permission prompt or question a run is `awaiting_input` on. */
         respond(run: RunRef, input: {
             requestId: string;
             reply: AgentRunReply;
         }): Promise<AgentRun>;
         /**
-         * Resolve once the run needs attention: terminal, or `awaiting_input`
-         * unless `until: "terminal"`. Push-based; no polling.
+         * Every lifecycle state of the run, starting with its current one, until a
+         * terminal state is yielded. Push-based (server-sent events); no polling.
+         * Answer `awaiting_input` states with `runs.respond()` while iterating.
+         */
+        watch(run: RunRef, options?: RunWatchOptions): AsyncIterable<AgentRun>;
+        /**
+         * Resolve with the first state that needs attention: terminal, or
+         * `awaiting_input` unless `until: "terminal"`. A thin helper over `watch()`.
          */
         wait(run: RunRef, options?: RunWaitOptions): Promise<AgentRun>;
-        wait(workspaceId: string, runId: string, options?: RunWaitOptions): Promise<AgentRun>;
+        events(run: RunRef, options?: RunWatchOptions): AsyncIterable<AgentRunEvent>;
+        result(run: RunRef, options?: RunResultOptions): Promise<AgentRunResult>;
     };
     catalog: {
         agentTypes(input?: {
@@ -64,5 +69,10 @@ export type GittermClient = {
         list(): Promise<ModelCredential[]>;
         listProviders(): Promise<ModelProviderInfo[]>;
     };
+    models: {
+        list(options?: {
+            provider?: string;
+        }): Promise<ModelInfo[]>;
+    };
 };
 export declare function createGittermClient(options?: GittermClientOptions): GittermClient;

package/dist/direct/client.d.ts

@@ -1,6 +1,8 @@
-import type { DirectProviderAdapter, DirectProviderConfig, DirectAuthAttempt, DirectAuthAttemptStatus, DirectAuthIntegration, DirectAuthWaitOptions, DirectModelCredential, DirectRun, DirectRunCreateInput, DirectRunMessage, DirectRunWaitOptions, DirectWorkspace, DirectWorkspaceCreateInput, DirectWorkspaceSetupStatus, DirectWorkspaceSetupWaitOptions } from "./types.js";
+import type { DirectProviderAdapter, DirectProviderConfig, DirectAuthAttempt, DirectAuthAttemptStatus, DirectAuthIntegration, DirectAuthWaitOptions, DirectModelCredential, DirectRun, DirectRunCreateInput, DirectWorkspace, DirectWorkspaceCreateInput, DirectWorkspaceSetupStatus, DirectWorkspaceSetupWaitOptions } from "./types.js";
 export type DirectGittermClientOptions = {
     provider: DirectProviderAdapter | DirectProviderConfig;
+    /** Used for OpenCode runtime requests (provider adapters own their own transports). */
+    fetch?: typeof fetch;
 };
 export declare function createDirectGittermClient(options: DirectGittermClientOptions): {
     provider: {
@@ -41,20 +43,19 @@ export declare function createDirectGittermClient(options: DirectGittermClientOp
     };
     runs: {
         create(input: DirectRunCreateInput): Promise<DirectRun>;
-        get: (run: DirectRun, workspace: DirectWorkspace) => Promise<{
-            status: "running" | "completed" | "failed" | "cancelled" | "retrying";
-            error: string | null;
-            finalText: string | null;
-            id: string;
-            workspaceId: string;
-            sessionId: string;
-            messageId: string;
-            title: string;
-            submittedAt: string;
+        messages(run: DirectRun): Promise<import("./types.js").DirectRunMessage[]>;
+        cancel(run: DirectRun): Promise<{
+            cancelled: boolean;
         }>;
-        wait(run: DirectRun, workspace: DirectWorkspace, wait?: DirectRunWaitOptions): Promise<DirectRun>;
-        messages(run: DirectRun, workspace: DirectWorkspace): Promise<DirectRunMessage[]>;
-        cancel(run: DirectRun, workspace: DirectWorkspace): Promise<boolean>;
+        events: (ref: DirectRun, options?: import("../types.js").RunWatchOptions) => AsyncIterable<import("../types.js").AgentRunEvent<DirectRun>>;
+        wait: (ref: DirectRun, options?: import("../types.js").RunWaitOptions) => Promise<DirectRun>;
+        result: (ref: DirectRun, options?: import("../types.js").RunResultOptions) => Promise<import("../types.js").AgentRunResult<DirectRun>>;
+        get: (run: DirectRun) => Promise<DirectRun>;
+        watch: (run: DirectRun, options?: import("../types.js").RunWatchOptions) => AsyncGenerator<DirectRun>;
+        respond: (run: DirectRun, input: {
+            requestId: string;
+            reply: import("../types.js").AgentRunReply;
+        }) => Promise<DirectRun>;
     };
 };
 export type DirectGittermClient = ReturnType<typeof createDirectGittermClient>;