@gitterm/sdk 0.0.1 → 0.0.3

package/README.md

@@ -12,13 +12,62 @@ bun add @gitterm/sdk
 npm install @gitterm/sdk
 ```
 
+## Switching servers (hosted vs self-hosted)
+
+The default API is the hosted service at `https://api.gitterm.dev`. Self-hosted
+instances use the same SDK — pass your instance’s base URL as `serverUrl`.
+
+| Deployment  | Example `serverUrl`           |
+| ----------- | ----------------------------- |
+| Hosted      | `https://api.gitterm.dev`     |
+| Self-hosted | `https://gitterm.example.com` |
+| Local dev   | `http://localhost:3000`       |
+
+### Explicit client (recommended for apps)
+
+```ts
+import { createGittermClient } from "@gitterm/sdk";
+
+// Hosted
+const hosted = createGittermClient({
+  serverUrl: "https://api.gitterm.dev",
+  token: process.env.GITTERM_API_TOKEN,
+});
+
+// Self-hosted / local
+const selfHosted = createGittermClient({
+  serverUrl: "https://gitterm.example.com", // or http://localhost:3000
+  token: process.env.GITTERM_API_TOKEN,
+});
+```
+
+### Environment variables
+
+```bash
+export GITTERM_SERVER_URL=https://gitterm.example.com
+export GITTERM_API_TOKEN=gt_...
+```
+
+```ts
+// Picks up GITTERM_SERVER_URL + GITTERM_API_TOKEN
+const client = createGittermClient();
+```
+
+### CLI saved login
+
+If you omit both options, the SDK also reads `~/.config/gitterm/cli.json` written by
+`gitterm login` / `gitterm login --server <url>`.
+
+**Resolution order:** constructor options → `GITTERM_SERVER_URL` / `GITTERM_API_TOKEN` → CLI config file.
+
+Create tokens in the dashboard under **Settings → Account → API tokens**, or via
+`gitterm login` (device-code flow). Tokens are the same `gt_...` shape on hosted and
+self-hosted.
+
 ## Usage
 
 ### With an explicit API token
 
-Create a token in the GitTerm dashboard under **Settings → Account → API tokens**
-(revocable, optional expiry), or obtain one via `gitterm login`.
-
 ```ts
 import { createGittermClient } from "@gitterm/sdk";
 
@@ -32,13 +81,10 @@ const { workspaces } = await client.workspaces.list();
 
 ### With the CLI's saved login
 
-If you omit `serverUrl`/`token`, the SDK reads the config written by `gitterm login`
-(`~/.config/gitterm/cli.json`), falling back to the `GITTERM_SERVER_URL` and
-`GITTERM_API_TOKEN` environment variables.
-
 ```ts
 const client = createGittermClient();
 const status = await client.auth.status();
+// status + client.serverUrl show which account and server you hit
 ```
 
 ### API
@@ -47,14 +93,24 @@ const status = await client.auth.status();
 client.auth.status();                 // -> { userId, email, name, plan, authMethod }
 client.workspaces.list(options?);     // -> { workspaces, pagination }
 client.workspaces.get(workspaceId);
+client.workspaces.getRuntimeAccess(workspaceId); // read-only; never resumes compute
+client.workspaces.ensureRunning(workspaceId, options?);
 client.workspaces.pause(workspaceId);
 client.workspaces.restart(workspaceId);
 client.workspaces.terminate(workspaceId);
-client.workspaces.create(input);      // needs agentTypeId + cloudProviderId, see catalog
+client.workspaces.createSandbox({
+  idempotencyKey, repo, branch, baseCommit, checkoutRef,
+  agent, provider, persistent, // provider is optional
+});
 client.catalog.agentTypes();
 client.catalog.cloudProviders();
+client.catalog.resolveSandboxDefaults({ agent, provider });
 ```
 
+`agent` is the unique enabled agent name (for example `"OpenCode"`).
+`provider` is the unique enabled provider name (for example `"E2B"`).
+Omit `provider` to use the preferred default sandbox provider.
+
 ### Errors
 
 Every method throws `GittermError` with a stable `code`:
@@ -71,24 +127,35 @@ try {
 }
 ```
 
-Codes: `NOT_LOGGED_IN`, `UNAUTHORIZED`, `NOT_FOUND`, `FORBIDDEN`, `BAD_REQUEST`,
-`SERVER_ERROR`, `NETWORK`.
+Workspace lifecycle failures are also exposed as `WorkspaceLifecycleError`, with stable
+`WORKSPACE_TERMINATED`, `WORKSPACE_NON_RECOVERABLE`, `WORKSPACE_START_TIMEOUT`, and
+`WORKSPACE_RESTART_FAILED` codes. General codes are
+`NOT_LOGGED_IN`, `UNAUTHORIZED`, `NOT_FOUND`, `FORBIDDEN`, `BAD_REQUEST`,
+`SERVER_ERROR`, and `NETWORK`.
+
+The package ships self-contained declarations from `dist`; TypeScript consumers do not
+need GitTerm's API package or tRPC server types.
 
 ### Obtaining a token programmatically
 
-The device-code flow used by `gitterm login` is exposed for integrations:
+The device-code flow used by `gitterm login` is exposed for integrations. Pass the
+server URL of the instance you want to log into:
 
 ```ts
 import { loginWithDeviceCode, saveConfig, DEFAULT_GITTERM_SERVER_URL } from "@gitterm/sdk";
 
-const { token } = await loginWithDeviceCode(DEFAULT_GITTERM_SERVER_URL, {
+// Hosted: DEFAULT_GITTERM_SERVER_URL ("https://api.gitterm.dev")
+// Self-hosted: "https://gitterm.example.com" or "http://localhost:3000"
+const serverUrl = process.env.GITTERM_SERVER_URL ?? DEFAULT_GITTERM_SERVER_URL;
+
+const { token } = await loginWithDeviceCode(serverUrl, {
   onCode: ({ verificationUri, userCode }) => {
     console.log(`Visit ${verificationUri} and enter ${userCode}`);
   },
 });
 
 await saveConfig({
-  serverUrl: DEFAULT_GITTERM_SERVER_URL,
+  serverUrl,
   token,
   createdAt: Date.now(),
 });

package/dist/client.d.ts

@@ -0,0 +1,40 @@
+import type { AgentType, AuthStatus, CloudProvider, Workspace, WorkspaceCreateInput, WorkspaceCreateResult, WorkspaceEnsureRunningResult, WorkspaceListOptions, WorkspaceListResult, WorkspaceRestartResult, WorkspaceRuntimeAccess, WorkspacePauseResult, WorkspaceTerminateResult, SandboxDefaults, SandboxDefaultsInput } from "./types.js";
+export type GittermClientOptions = {
+    serverUrl?: string;
+    token?: string;
+    configPath?: string;
+    fetch?: typeof fetch;
+};
+export type GittermClient = {
+    serverUrl: string;
+    auth: {
+        status(): Promise<AuthStatus>;
+    };
+    workspaces: {
+        list(input?: WorkspaceListOptions): Promise<WorkspaceListResult>;
+        get(workspaceId: string): Promise<Workspace>;
+        getRuntimeAccess(workspaceId: string): Promise<WorkspaceRuntimeAccess>;
+        ensureRunning(workspaceId: string, options?: {
+            timeoutMs?: number;
+            pollIntervalMs?: number;
+        }): Promise<WorkspaceEnsureRunningResult>;
+        pause(workspaceId: string): Promise<WorkspacePauseResult>;
+        restart(workspaceId: string): Promise<WorkspaceRestartResult>;
+        terminate(workspaceId: string): Promise<WorkspaceTerminateResult>;
+        create(input: WorkspaceCreateInput): Promise<WorkspaceCreateResult>;
+        createSandbox(input: WorkspaceCreateInput): Promise<WorkspaceCreateResult>;
+    };
+    catalog: {
+        agentTypes(input?: {
+            serverOnly?: boolean;
+        }): Promise<AgentType[]>;
+        cloudProviders(input?: {
+            localOnly?: boolean;
+            cloudOnly?: boolean;
+            sandboxOnly?: boolean;
+            nonSandboxOnly?: boolean;
+        }): Promise<CloudProvider[]>;
+        resolveSandboxDefaults(input: SandboxDefaultsInput): Promise<SandboxDefaults>;
+    };
+};
+export declare function createGittermClient(options?: GittermClientOptions): GittermClient;

package/dist/config.d.ts

@@ -0,0 +1,11 @@
+export declare const DEFAULT_GITTERM_SERVER_URL = "https://api.gitterm.dev";
+export type CliConfig = {
+    serverUrl: string;
+    token: string;
+    createdAt: number;
+};
+export declare function getConfigPath(configPath?: string): string;
+export declare function loadConfig(configPath?: string): Promise<CliConfig | null>;
+export declare function loadConfigSync(configPath?: string): CliConfig | null;
+export declare function saveConfig(config: CliConfig, configPath?: string): Promise<void>;
+export declare function deleteConfig(configPath?: string): Promise<void>;

package/dist/device-login.d.ts

@@ -0,0 +1,15 @@
+export type DeviceCodeInfo = {
+    deviceCode: string;
+    userCode: string;
+    verificationUri: string;
+    intervalSeconds: number;
+    expiresInSeconds: number;
+};
+export type LoginWithDeviceCodeOptions = {
+    clientName?: string;
+    fetch?: typeof fetch;
+    onCode?: (code: Omit<DeviceCodeInfo, "deviceCode">) => void | Promise<void>;
+};
+export declare function loginWithDeviceCode(serverUrl: string, options?: LoginWithDeviceCodeOptions): Promise<{
+    token: string;
+}>;

package/dist/errors.d.ts

@@ -0,0 +1,15 @@
+export type GittermErrorCode = "NOT_LOGGED_IN" | "UNAUTHORIZED" | "NOT_FOUND" | "FORBIDDEN" | "BAD_REQUEST" | "SERVER_ERROR" | "NETWORK" | WorkspaceLifecycleErrorCode;
+export type WorkspaceLifecycleErrorCode = "WORKSPACE_TERMINATED" | "WORKSPACE_NON_RECOVERABLE" | "WORKSPACE_START_TIMEOUT" | "WORKSPACE_RESTART_FAILED";
+export declare class GittermError extends Error {
+    readonly code: GittermErrorCode;
+    readonly cause?: unknown;
+    constructor(code: GittermErrorCode, message: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class WorkspaceLifecycleError extends GittermError {
+    readonly code: WorkspaceLifecycleErrorCode;
+    constructor(code: WorkspaceLifecycleErrorCode, message: string, options?: {
+        cause?: unknown;
+    });
+}

package/dist/index.d.ts

@@ -1,213 +1,8 @@
-/**
- * Hand-maintained public type surface for @gitterm/sdk.
- *
- * External npm consumers resolve these types instead of the TypeScript
- * sources, because the sources derive types from the private @gitterm/api
- * router. Keep this file in sync with src/types.ts and src/client.ts.
- *
- * TODO: replace with generated declarations once the AppRouter types can be
- * bundled into a standalone .d.ts.
- */
-
-export const DEFAULT_GITTERM_SERVER_URL: string;
-
-export type CliConfig = {
-  serverUrl: string;
-  token: string;
-  createdAt: number;
-};
-
-export type GittermErrorCode =
-  | "NOT_LOGGED_IN"
-  | "UNAUTHORIZED"
-  | "NOT_FOUND"
-  | "FORBIDDEN"
-  | "BAD_REQUEST"
-  | "SERVER_ERROR"
-  | "NETWORK";
-
-export class GittermError extends Error {
-  readonly code: GittermErrorCode;
-  readonly cause?: unknown;
-  constructor(code: GittermErrorCode, message: string, options?: { cause?: unknown });
-}
-
-export type GittermClientOptions = {
-  serverUrl?: string;
-  token?: string;
-  configPath?: string;
-  fetch?: typeof fetch;
-};
-
-export type AuthStatus = {
-  loggedIn: true;
-  userId: string;
-  email: string;
-  name: string;
-  plan: string;
-  authMethod: "session" | "apiToken";
-};
-
-export type WorkspaceStatus = "pending" | "running" | "paused" | "terminated";
-export type WorkspaceHostingType = "cloud" | "local";
-
-export type Workspace = {
-  id: string;
-  name: string | null;
-  status: WorkspaceStatus;
-  repositoryUrl: string | null;
-  repositoryBranch: string | null;
-  baseCommit: string | null;
-  checkoutRef: string | null;
-  domain: string;
-  subdomain: string | null;
-  persistent: boolean;
-  hostingType: WorkspaceHostingType;
-  serverOnly: boolean;
-  workspaceProfile: string;
-  cloudProviderId: string;
-  agentType: { id: string; name: string; description: string | null } | null;
-  image: { id: string; name: string; imageId: string } | null;
-  startedAt: string | null;
-  stoppedAt: string | null;
-  terminatedAt: string | null;
-  lastActiveAt: string | null;
-  updatedAt: string | null;
-};
-
-export type WorkspaceRuntimeAccess = {
-  workspaceId: string;
-  status: WorkspaceStatus;
-  url: string | null;
-  headers?: Record<string, string>;
-  password?: string;
-  directory: string;
-  repo: string | null;
-  branch: string | null;
-  baseCommit: string | null;
-  checkoutRef: string | null;
-  persistent: boolean;
-  recoverable: boolean;
-  providerKey: string | null;
-};
-
-export type WorkspaceCreateResult = {
-  workspace: Workspace;
-  runtime: WorkspaceRuntimeAccess;
-};
-
-export type WorkspaceListOptions = {
-  limit?: number;
-  offset?: number;
-  status?: "all" | "active" | "terminated";
-};
-
-export type WorkspaceListResult = {
-  workspaces: Workspace[];
-  pagination: {
-    total: number;
-    limit: number;
-    offset: number;
-    hasMore: boolean;
-  };
-};
-
-export type WorkspaceCreateInput = {
-  name?: string;
-  repo?: string;
-  branch?: string;
-  baseCommit?: string;
-  checkoutRef?: string;
-  subdomain?: string;
-  agentTypeId: string;
-  cloudProviderId: string;
-  regionId?: string;
-  gitIntegrationId?: string;
-  persistent: boolean;
-  workspaceProfile?: "standard" | "ssh-enabled";
-};
-
-export type WorkspaceStopResult = { durationMinutes: number };
-export type WorkspacePauseResult = WorkspaceStopResult;
-export type WorkspaceRestartResult = { status: WorkspaceStatus };
-export type WorkspaceTerminateResult = {
-  workspace: Workspace | null;
-  cleanupInBackground: boolean;
-};
-export type WorkspaceEnsureRunningResult = {
-  workspace: Workspace;
-  runtime: WorkspaceRuntimeAccess;
-};
-
-export type AgentType = {
-  id: string;
-  name: string;
-  description: string | null;
-  serverOnly: boolean;
-  isEnabled: boolean;
-  createdAt: Date | string;
-  updatedAt: Date | string;
-};
-
-export type CloudProvider = Record<string, unknown> & {
-  id: string;
-  name: string;
-  providerKey: string;
-  regions?: Array<Record<string, unknown>>;
-};
-
-export type GittermClient = {
-  serverUrl: string;
-  auth: {
-    status(): Promise<AuthStatus>;
-  };
-  workspaces: {
-    list(input?: WorkspaceListOptions): Promise<WorkspaceListResult>;
-    get(workspaceId: string): Promise<Workspace>;
-    getRuntimeAccess(workspaceId: string): Promise<WorkspaceRuntimeAccess>;
-    ensureRunning(
-      workspaceId: string,
-      options?: { timeoutMs?: number; pollIntervalMs?: number },
-    ): Promise<WorkspaceEnsureRunningResult>;
-    pause(workspaceId: string): Promise<WorkspacePauseResult>;
-    restart(workspaceId: string): Promise<WorkspaceRestartResult>;
-    terminate(workspaceId: string): Promise<WorkspaceTerminateResult>;
-    create(input: WorkspaceCreateInput): Promise<WorkspaceCreateResult>;
-    createSandbox(input: WorkspaceCreateInput): Promise<WorkspaceCreateResult>;
-  };
-  catalog: {
-    agentTypes(input?: { serverOnly?: boolean }): Promise<AgentType[]>;
-    cloudProviders(input?: {
-      localOnly?: boolean;
-      cloudOnly?: boolean;
-      sandboxOnly?: boolean;
-      nonSandboxOnly?: boolean;
-    }): Promise<CloudProvider[]>;
-  };
-};
-
-export function createGittermClient(options?: GittermClientOptions): GittermClient;
-export function getConfigPath(configPath?: string): string;
-export function loadConfig(configPath?: string): Promise<CliConfig | null>;
-export function loadConfigSync(configPath?: string): CliConfig | null;
-export function saveConfig(config: CliConfig, configPath?: string): Promise<void>;
-export function deleteConfig(configPath?: string): Promise<void>;
-
-export type DeviceCodeInfo = {
-  deviceCode: string;
-  userCode: string;
-  verificationUri: string;
-  intervalSeconds: number;
-  expiresInSeconds: number;
-};
-
-export type LoginWithDeviceCodeOptions = {
-  clientName?: string;
-  fetch?: typeof fetch;
-  onCode?: (code: Omit<DeviceCodeInfo, "deviceCode">) => void | Promise<void>;
-};
-
-export function loginWithDeviceCode(
-  serverUrl: string,
-  options?: LoginWithDeviceCodeOptions,
-): Promise<{ token: string }>;
+export { createGittermClient, type GittermClient, type GittermClientOptions } from "./client.js";
+export { DEFAULT_GITTERM_SERVER_URL, getConfigPath, loadConfig, loadConfigSync, saveConfig, deleteConfig, } from "./config.js";
+export type { CliConfig } from "./config.js";
+export { loginWithDeviceCode } from "./device-login.js";
+export type { DeviceCodeInfo, LoginWithDeviceCodeOptions } from "./device-login.js";
+export { GittermError, WorkspaceLifecycleError } from "./errors.js";
+export type { GittermErrorCode, WorkspaceLifecycleErrorCode } from "./errors.js";
+export type { AgentType, AuthStatus, CloudProvider, SandboxDefaults, Workspace, WorkspaceCreateInput, WorkspaceCreateResult, WorkspaceEnsureRunningResult, WorkspaceHostingType, WorkspaceListOptions, WorkspaceListResult, WorkspaceRestartResult, WorkspaceRuntimeAccess, WorkspaceStatus, WorkspacePauseResult, WorkspaceTerminateResult, SandboxDefaultsInput, } from "./types.js";

package/dist/index.js

@@ -62,6 +62,13 @@ class GittermError extends Error {
   }
 }
 
+class WorkspaceLifecycleError extends GittermError {
+  constructor(code, message, options = {}) {
+    super(code, message, options);
+    this.name = "WorkspaceLifecycleError";
+  }
+}
+
 // src/client.ts
 function envValue(name) {
   const value = typeof process !== "undefined" ? process.env[name] : undefined;
@@ -121,7 +128,7 @@ function normalizeWorkspace(workspace) {
       imageId: workspace.image.imageId
     } : null,
     startedAt: toIso(workspace.startedAt),
-    stoppedAt: toIso(workspace.stoppedAt),
+    pausedAt: toIso(workspace.pausedAt),
     terminatedAt: toIso(workspace.terminatedAt),
     lastActiveAt: toIso(workspace.lastActiveAt),
     updatedAt: toIso(workspace.updatedAt)
@@ -172,6 +179,24 @@ async function runWithServer(serverUrl, operation) {
         });
       }
       const code = mapTrpcCode(trpcCode);
+      if (/WORKSPACE_TERMINATED/.test(error.message)) {
+        throw new WorkspaceLifecycleError("WORKSPACE_TERMINATED", error.message, { cause: error });
+      }
+      if (/WORKSPACE_NON_RECOVERABLE/.test(error.message)) {
+        throw new WorkspaceLifecycleError("WORKSPACE_NON_RECOVERABLE", error.message, {
+          cause: error
+        });
+      }
+      if (/WORKSPACE_START_TIMEOUT/.test(error.message)) {
+        throw new WorkspaceLifecycleError("WORKSPACE_START_TIMEOUT", error.message, {
+          cause: error
+        });
+      }
+      if (/WORKSPACE_RESTART_FAILED/.test(error.message)) {
+        throw new WorkspaceLifecycleError("WORKSPACE_RESTART_FAILED", error.message, {
+          cause: error
+        });
+      }
       throw new GittermError(code, code === "UNAUTHORIZED" ? "Not logged in or token expired. Run: gitterm login" : error.message, { cause: error });
     }
     throw new GittermError("NETWORK", error instanceof Error ? error.message : "Network request failed", { cause: error });
@@ -190,7 +215,15 @@ function createGittermClient(options = {}) {
   });
   const run = (operation) => runWithServer(credentials.serverUrl, operation);
   const createWorkspace = (input) => run(async () => {
-    const result = await trpc.workspace.createWorkspace.mutate(input);
+    const { agent, provider, regionId, ...workspaceInput } = input;
+    const defaults = await trpc.workspace.resolveSandboxDefaults.query({ agent, provider });
+    const apiInput = {
+      ...workspaceInput,
+      agentTypeId: defaults.agentTypeId,
+      cloudProviderId: defaults.cloudProviderId,
+      regionId: regionId ?? defaults.regionId
+    };
+    const result = await trpc.workspace.createWorkspace.mutate(apiInput);
     const workspace = normalizeWorkspace(result.workspace);
     if (!workspace)
       throw new GittermError("SERVER_ERROR", "Workspace creation failed");
@@ -283,7 +316,8 @@ function createGittermClient(options = {}) {
       cloudProviders: (input) => run(async () => {
         const result = await trpc.workspace.listCloudProviders.query(input);
         return result.cloudProviders;
-      })
+      }),
+      resolveSandboxDefaults: (input) => run(async () => trpc.workspace.resolveSandboxDefaults.query(input))
     }
   };
 }
@@ -334,6 +368,7 @@ export {
   getConfigPath,
   deleteConfig,
   createGittermClient,
+  WorkspaceLifecycleError,
   GittermError,
   DEFAULT_GITTERM_SERVER_URL
 };

package/dist/types.d.ts

@@ -0,0 +1,133 @@
+export type AuthStatus = {
+    loggedIn: true;
+    userId: string;
+    email: string;
+    name: string;
+    plan: string;
+    authMethod: "session" | "apiToken";
+};
+export type WorkspaceStatus = "pending" | "running" | "paused" | "terminated";
+export type WorkspaceHostingType = "cloud" | "local";
+export type Workspace = {
+    id: string;
+    name: string | null;
+    status: WorkspaceStatus;
+    repositoryUrl: string | null;
+    repositoryBranch: string | null;
+    baseCommit: string | null;
+    checkoutRef: string | null;
+    domain: string;
+    subdomain: string | null;
+    persistent: boolean;
+    hostingType: WorkspaceHostingType;
+    serverOnly: boolean;
+    workspaceProfile: string;
+    cloudProviderId: string;
+    agentType: {
+        id: string;
+        name: string;
+        description: string | null;
+    } | null;
+    image: {
+        id: string;
+        name: string;
+        imageId: string;
+    } | null;
+    startedAt: string | null;
+    pausedAt: string | null;
+    terminatedAt: string | null;
+    lastActiveAt: string | null;
+    updatedAt: string | null;
+};
+export type WorkspaceRuntimeAccess = {
+    workspaceId: string;
+    status: WorkspaceStatus;
+    url: string | null;
+    headers?: Record<string, string>;
+    password?: string;
+    directory: string;
+    repo: string | null;
+    branch: string | null;
+    baseCommit: string | null;
+    checkoutRef: string | null;
+    persistent: boolean;
+    recoverable: boolean;
+    providerKey: string | null;
+};
+export type WorkspaceCreateResult = {
+    workspace: Workspace;
+    runtime: WorkspaceRuntimeAccess;
+};
+export type WorkspaceListOptions = {
+    limit?: number;
+    offset?: number;
+    status?: "all" | "active" | "terminated";
+};
+export type WorkspaceListResult = {
+    workspaces: Workspace[];
+    pagination: {
+        total: number;
+        limit: number;
+        offset: number;
+        hasMore: boolean;
+    };
+};
+export type WorkspaceCreateInput = {
+    idempotencyKey?: string;
+    name?: string;
+    repo?: string;
+    branch?: string;
+    baseCommit?: string;
+    checkoutRef?: string;
+    subdomain?: string;
+    /** Unique enabled agent name. */
+    agent: string;
+    /** Unique enabled provider name. Optional when a preferred default exists. */
+    provider?: string;
+    regionId?: string;
+    gitIntegrationId?: string;
+    persistent: boolean;
+    workspaceProfile?: "standard" | "ssh-enabled";
+    modelCredentialIds?: string[];
+};
+export type WorkspaceRestartResult = {
+    status: WorkspaceStatus;
+};
+export type WorkspacePauseResult = {
+    durationMinutes: number;
+};
+export type WorkspaceTerminateResult = {
+    workspace: Workspace | null;
+    cleanupInBackground: boolean;
+};
+export type WorkspaceEnsureRunningResult = {
+    workspace: Workspace;
+    runtime: WorkspaceRuntimeAccess;
+};
+export type AgentType = {
+    id: string;
+    name: string;
+    description: string | null;
+    serverOnly: boolean;
+    isEnabled: boolean;
+    createdAt: Date | string;
+    updatedAt: Date | string;
+};
+export type CloudProvider = {
+    id: string;
+    name: string;
+    providerKey: string;
+    regions?: Array<Record<string, unknown>>;
+    [key: string]: unknown;
+};
+export type SandboxDefaults = {
+    agent: string;
+    provider: string;
+    agentTypeId: string;
+    cloudProviderId: string;
+    regionId?: string;
+};
+export type SandboxDefaultsInput = {
+    agent: string;
+    provider?: string;
+};

package/package.json

@@ -1,15 +1,14 @@
 {
   "name": "@gitterm/sdk",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "files": [
-    "dist",
-    "src/index.d.ts"
+    "dist"
   ],
   "type": "module",
   "exports": {
     ".": {
-      "types": "./src/index.d.ts",
-      "bun": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "bun": "./dist/index.js",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     }
@@ -18,7 +17,7 @@
     "access": "public"
   },
   "scripts": {
-    "build": "bun build src/index.ts --outdir dist --target node --format esm --external @trpc/client && cp src/index.d.ts dist/index.d.ts",
+    "build": "rm -rf dist && bun build src/index.ts --outdir dist --target node --format esm --external @trpc/client && tsc -p tsconfig.build.json",
     "prepublishOnly": "bun run check-types && bun run build",
     "check-types": "tsc --noEmit"
   },
@@ -27,7 +26,6 @@
   },
   "devDependencies": {
     "@gitterm/api": "workspace:*",
-    "@gitterm/config": "workspace:*",
     "@trpc/server": "catalog:",
     "@types/bun": "^1.2.6",
     "typescript": "^5.8.2"

package/src/index.d.ts

@@ -1,213 +0,0 @@
-/**
- * Hand-maintained public type surface for @gitterm/sdk.
- *
- * External npm consumers resolve these types instead of the TypeScript
- * sources, because the sources derive types from the private @gitterm/api
- * router. Keep this file in sync with src/types.ts and src/client.ts.
- *
- * TODO: replace with generated declarations once the AppRouter types can be
- * bundled into a standalone .d.ts.
- */
-
-export const DEFAULT_GITTERM_SERVER_URL: string;
-
-export type CliConfig = {
-  serverUrl: string;
-  token: string;
-  createdAt: number;
-};
-
-export type GittermErrorCode =
-  | "NOT_LOGGED_IN"
-  | "UNAUTHORIZED"
-  | "NOT_FOUND"
-  | "FORBIDDEN"
-  | "BAD_REQUEST"
-  | "SERVER_ERROR"
-  | "NETWORK";
-
-export class GittermError extends Error {
-  readonly code: GittermErrorCode;
-  readonly cause?: unknown;
-  constructor(code: GittermErrorCode, message: string, options?: { cause?: unknown });
-}
-
-export type GittermClientOptions = {
-  serverUrl?: string;
-  token?: string;
-  configPath?: string;
-  fetch?: typeof fetch;
-};
-
-export type AuthStatus = {
-  loggedIn: true;
-  userId: string;
-  email: string;
-  name: string;
-  plan: string;
-  authMethod: "session" | "apiToken";
-};
-
-export type WorkspaceStatus = "pending" | "running" | "paused" | "terminated";
-export type WorkspaceHostingType = "cloud" | "local";
-
-export type Workspace = {
-  id: string;
-  name: string | null;
-  status: WorkspaceStatus;
-  repositoryUrl: string | null;
-  repositoryBranch: string | null;
-  baseCommit: string | null;
-  checkoutRef: string | null;
-  domain: string;
-  subdomain: string | null;
-  persistent: boolean;
-  hostingType: WorkspaceHostingType;
-  serverOnly: boolean;
-  workspaceProfile: string;
-  cloudProviderId: string;
-  agentType: { id: string; name: string; description: string | null } | null;
-  image: { id: string; name: string; imageId: string } | null;
-  startedAt: string | null;
-  stoppedAt: string | null;
-  terminatedAt: string | null;
-  lastActiveAt: string | null;
-  updatedAt: string | null;
-};
-
-export type WorkspaceRuntimeAccess = {
-  workspaceId: string;
-  status: WorkspaceStatus;
-  url: string | null;
-  headers?: Record<string, string>;
-  password?: string;
-  directory: string;
-  repo: string | null;
-  branch: string | null;
-  baseCommit: string | null;
-  checkoutRef: string | null;
-  persistent: boolean;
-  recoverable: boolean;
-  providerKey: string | null;
-};
-
-export type WorkspaceCreateResult = {
-  workspace: Workspace;
-  runtime: WorkspaceRuntimeAccess;
-};
-
-export type WorkspaceListOptions = {
-  limit?: number;
-  offset?: number;
-  status?: "all" | "active" | "terminated";
-};
-
-export type WorkspaceListResult = {
-  workspaces: Workspace[];
-  pagination: {
-    total: number;
-    limit: number;
-    offset: number;
-    hasMore: boolean;
-  };
-};
-
-export type WorkspaceCreateInput = {
-  name?: string;
-  repo?: string;
-  branch?: string;
-  baseCommit?: string;
-  checkoutRef?: string;
-  subdomain?: string;
-  agentTypeId: string;
-  cloudProviderId: string;
-  regionId?: string;
-  gitIntegrationId?: string;
-  persistent: boolean;
-  workspaceProfile?: "standard" | "ssh-enabled";
-};
-
-export type WorkspaceStopResult = { durationMinutes: number };
-export type WorkspacePauseResult = WorkspaceStopResult;
-export type WorkspaceRestartResult = { status: WorkspaceStatus };
-export type WorkspaceTerminateResult = {
-  workspace: Workspace | null;
-  cleanupInBackground: boolean;
-};
-export type WorkspaceEnsureRunningResult = {
-  workspace: Workspace;
-  runtime: WorkspaceRuntimeAccess;
-};
-
-export type AgentType = {
-  id: string;
-  name: string;
-  description: string | null;
-  serverOnly: boolean;
-  isEnabled: boolean;
-  createdAt: Date | string;
-  updatedAt: Date | string;
-};
-
-export type CloudProvider = Record<string, unknown> & {
-  id: string;
-  name: string;
-  providerKey: string;
-  regions?: Array<Record<string, unknown>>;
-};
-
-export type GittermClient = {
-  serverUrl: string;
-  auth: {
-    status(): Promise<AuthStatus>;
-  };
-  workspaces: {
-    list(input?: WorkspaceListOptions): Promise<WorkspaceListResult>;
-    get(workspaceId: string): Promise<Workspace>;
-    getRuntimeAccess(workspaceId: string): Promise<WorkspaceRuntimeAccess>;
-    ensureRunning(
-      workspaceId: string,
-      options?: { timeoutMs?: number; pollIntervalMs?: number },
-    ): Promise<WorkspaceEnsureRunningResult>;
-    pause(workspaceId: string): Promise<WorkspacePauseResult>;
-    restart(workspaceId: string): Promise<WorkspaceRestartResult>;
-    terminate(workspaceId: string): Promise<WorkspaceTerminateResult>;
-    create(input: WorkspaceCreateInput): Promise<WorkspaceCreateResult>;
-    createSandbox(input: WorkspaceCreateInput): Promise<WorkspaceCreateResult>;
-  };
-  catalog: {
-    agentTypes(input?: { serverOnly?: boolean }): Promise<AgentType[]>;
-    cloudProviders(input?: {
-      localOnly?: boolean;
-      cloudOnly?: boolean;
-      sandboxOnly?: boolean;
-      nonSandboxOnly?: boolean;
-    }): Promise<CloudProvider[]>;
-  };
-};
-
-export function createGittermClient(options?: GittermClientOptions): GittermClient;
-export function getConfigPath(configPath?: string): string;
-export function loadConfig(configPath?: string): Promise<CliConfig | null>;
-export function loadConfigSync(configPath?: string): CliConfig | null;
-export function saveConfig(config: CliConfig, configPath?: string): Promise<void>;
-export function deleteConfig(configPath?: string): Promise<void>;
-
-export type DeviceCodeInfo = {
-  deviceCode: string;
-  userCode: string;
-  verificationUri: string;
-  intervalSeconds: number;
-  expiresInSeconds: number;
-};
-
-export type LoginWithDeviceCodeOptions = {
-  clientName?: string;
-  fetch?: typeof fetch;
-  onCode?: (code: Omit<DeviceCodeInfo, "deviceCode">) => void | Promise<void>;
-};
-
-export function loginWithDeviceCode(
-  serverUrl: string,
-  options?: LoginWithDeviceCodeOptions,
-): Promise<{ token: string }>;