@gitterm/sdk 0.9.0 → 0.11.0

package/dist/client.d.ts

@@ -70,9 +70,13 @@ export type GittermClient = {
         listProviders(): Promise<ModelProviderInfo[]>;
     };
     bots: {
-        /** Claims (or renews) the right to run this saved bot; one process at a time. */
+        /**
+         * Claims (or renews) the right to run this saved bot; one process at a time. `updatedAt` is
+         * when its saved settings last changed (absent from older servers).
+         */
         acquireLease(leaseId: string): Promise<{
             success: true;
+            updatedAt?: string;
         }>;
         releaseLease(leaseId: string): Promise<{
             success: true;

package/dist/direct/index.js

@@ -2177,12 +2177,12 @@ var WORKSPACE_LIFECYCLE_ERROR_CODES = [
 
 class GittermError extends Error {
   code;
-  cause;
+  status;
   constructor(code, message, options = {}) {
-    super(message);
+    super(message, "cause" in options ? { cause: options.cause } : undefined);
     this.name = "GittermError";
     this.code = code;
-    this.cause = options.cause;
+    this.status = options.status;
   }
 }
 

package/dist/errors.d.ts

@@ -5,15 +5,18 @@ export type WorkspaceLifecycleErrorCode = "WORKSPACE_NOT_RUNNING" | "WORKSPACE_T
 export declare const WORKSPACE_LIFECYCLE_ERROR_CODES: readonly WorkspaceLifecycleErrorCode[];
 export declare class GittermError extends Error {
     readonly code: GittermErrorCode;
-    readonly cause?: unknown;
+    /** HTTP status of the API response; undefined when the server never answered. */
+    readonly status: number | undefined;
     constructor(code: GittermErrorCode, message: string, options?: {
         cause?: unknown;
+        status?: number;
     });
 }
 export declare class WorkspaceLifecycleError extends GittermError {
     readonly code: WorkspaceLifecycleErrorCode;
     constructor(code: WorkspaceLifecycleErrorCode, message: string, options?: {
         cause?: unknown;
+        status?: number;
     });
 }
 /** result() could not produce a successful result. The run remains inspectable. */

package/dist/index.js

@@ -68,12 +68,12 @@ var WORKSPACE_LIFECYCLE_ERROR_CODES = [
 
 class GittermError extends Error {
   code;
-  cause;
+  status;
   constructor(code, message, options = {}) {
-    super(message);
+    super(message, "cause" in options ? { cause: options.cause } : undefined);
     this.name = "GittermError";
     this.code = code;
-    this.cause = options.cause;
+    this.status = options.status;
   }
 }
 
@@ -426,27 +426,26 @@ function toGittermError(serverUrl, error) {
     return error;
   if (error instanceof TRPCClientError) {
     const data = error.data;
-    const trpcCode = data?.code;
-    if (!error.data) {
+    if (!data) {
       return new GittermError("NETWORK", `Could not reach the GitTerm server at ${serverUrl}`, {
-        cause: error
+        cause: error.cause ?? error
       });
     }
-    const code = mapTrpcCode(trpcCode);
-    const structuredLifecycleCode = WORKSPACE_LIFECYCLE_ERROR_CODES.find((candidate) => candidate === data?.workspaceLifecycleCode);
+    const status = { status: data.httpStatus };
+    const structuredLifecycleCode = WORKSPACE_LIFECYCLE_ERROR_CODES.find((candidate) => candidate === data.workspaceLifecycleCode);
     if (structuredLifecycleCode) {
-      return new WorkspaceLifecycleError(structuredLifecycleCode, error.message, { cause: error });
+      return new WorkspaceLifecycleError(structuredLifecycleCode, error.message, status);
     }
     if (error.message.startsWith("INPUT_NOT_PENDING:"))
-      return new GittermError("INPUT_NOT_PENDING", error.message, { cause: error });
+      return new GittermError("INPUT_NOT_PENDING", error.message, status);
     const credentialCode = credentialErrorCode(error.message);
     if (credentialCode)
-      return new GittermError(credentialCode, error.message, { cause: error });
+      return new GittermError(credentialCode, error.message, status);
     const lifecycleCode = WORKSPACE_LIFECYCLE_ERROR_CODES.find((candidate) => error.message.startsWith(`${candidate}:`));
-    if (lifecycleCode) {
-      return new WorkspaceLifecycleError(lifecycleCode, error.message, { cause: error });
-    }
-    return new GittermError(code, code === "UNAUTHORIZED" ? `Authentication failed: ${error.message}. Check that the API token is valid and has not expired.` : error.message, { cause: error });
+    if (lifecycleCode)
+      return new WorkspaceLifecycleError(lifecycleCode, error.message, status);
+    const code = mapTrpcCode(data.code);
+    return new GittermError(code, code === "UNAUTHORIZED" ? `${error.message}. Check your GitTerm API token, or create a new one in the dashboard.` : error.message, status);
   }
   return new GittermError("NETWORK", error instanceof Error ? error.message : "Network request failed", { cause: error });
 }

package/dist/types.d.ts

@@ -62,6 +62,7 @@ export type RunRef = {
     id: string;
 };
 export type WaitOptions = {
+    /** For `ensureRunning` the server maximum is 240000 (4 minutes). */
     timeoutMs?: number;
     pollIntervalMs?: number;
     /** Abort the wait early; the promise rejects with code `ABORTED`. */
@@ -262,7 +263,7 @@ export type McpConnectionDetails = {
     revision?: number;
     integration: "mcp" | "executor";
     url: string;
-    authType: "none" | "headers";
+    authType: "none" | "bearer" | "headers";
     codemode: boolean;
     toolCount: number | null;
     serverInfo: {
@@ -773,5 +774,7 @@ export type SavedBot = {
     instructions: string | null;
     /** A command run in the checkout before the agent starts in a new sandbox. */
     setup: string | null;
+    /** When the settings last changed (ISO 8601); absent from older servers. */
+    updatedAt?: string;
 };
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gitterm/sdk",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "files": [
     "dist"
   ],