@gitterm/sdk 0.3.0 → 0.4.0

package/README.md

@@ -450,7 +450,10 @@ Three things have to be true before a prompt can be delivered, and the SDK handl
 The shortest correct sequence is therefore:
 
 ```ts
-const { workspace } = await client.workspaces.create({ repo, setup: { afterAgent: ["npm ci"] } });
+const { workspace } = await client.workspaces.create({
+  repo,
+  setup: { afterAgent: ["npm ci"] },
+});
 const run = await client.runs.create({
   workspace,
   idempotencyKey: `review-${sha}`,
@@ -682,10 +685,10 @@ would otherwise change them for other runs on the same runtime.
 
 ## OpenCode API versions
 
-Managed workspaces run OpenCode V2 from `@opencode/cli@2` and use `opencodeApi: "v2"`. V2 stores
-credentials in SQLite; GitTerm writes a short-lived V1-shaped `auth.json` seed before first startup,
-triggers V2's supported credential import, then deletes the seed. Runs, questions, permissions, and
-events use GitTerm's V2 runtime adapter.
+Managed workspaces default to OpenCode V1 from `opencode-ai` and use `opencodeApi: "v1"`.
+Credentials are written to OpenCode's `auth.json` before the runtime starts. Runs, questions,
+permissions, and events use GitTerm's V1 runtime adapter. V2 remains selectable only for explicitly
+compatible images.
 
 ## Errors
 
@@ -784,12 +787,17 @@ let workspace = await direct.workspaces.create({
   repo: "https://github.com/acme/project",
   lifecycle: "ephemeral",
   models: {
-    providers: { anthropic: { source: "apiKey", apiKey: process.env.ANTHROPIC_API_KEY! } },
+    providers: {
+      anthropic: { source: "apiKey", apiKey: process.env.ANTHROPIC_API_KEY! },
+    },
   },
 });
 
 try {
-  const run = await direct.runs.create({ workspace, prompt: "Review the open pull request" });
+  const run = await direct.runs.create({
+    workspace,
+    prompt: "Review the open pull request",
+  });
   const completed = await direct.runs.result(run);
   console.log(completed.finalText);
 } finally {

package/dist/direct/index.js

@@ -823,12 +823,6 @@ function parseV2Signal(raw) {
       return null;
   }
 }
-// ../agent-runtime/src/opencode-credentials.ts
-var OPENCODE_V2_IMPORT_CREDENTIALS = String.raw`AUTH_FILE="\${OPENCODE_DATA_DIR:-\${XDG_DATA_HOME:-$HOME/.local/share}/opencode}/auth.json"
-if [ -f "$AUTH_FILE" ]; then
-  opencode auth list >/dev/null
-  rm -f "$AUTH_FILE"
-fi`;
 // ../agent-runtime/src/derive.ts
 var MISSING_ASSISTANT_GRACE_MS = 1e4;
 function deriveRunState(snapshot, context) {
@@ -1617,7 +1611,10 @@ function buildDirectProvisioningPlan(input) {
     throw new GittermError("MODEL_CREDENTIAL_INVALID", "Direct mode cannot inherit dashboard credentials");
   }
   for (const [key, source] of Object.entries(input.models?.providers ?? {})) {
-    const credential = { ...source, providerName: key };
+    const credential = {
+      ...source,
+      providerName: key
+    };
     const providerName = key.trim();
     if (!providerName)
       throw new Error("Model credential providerName is required");
@@ -1698,11 +1695,7 @@ function buildDirectProvisioningPlan(input) {
       port: DIRECT_OPENCODE_PORT
     },
     setup: {
-      beforeAgent: [
-        ...(input.opencode?.api ?? "v2") === "v2" ? [OPENCODE_V2_IMPORT_CREDENTIALS] : [],
-        ...github ? [github.setup] : [],
-        ...input.setup?.beforeAgent ?? []
-      ],
+      beforeAgent: [...github ? [github.setup] : [], ...input.setup?.beforeAgent ?? []],
       afterAgent: input.setup?.afterAgent ?? []
     }
   };
@@ -1727,7 +1720,9 @@ function railwayContainerEnvironment(plan) {
       } : {}
     } : {},
     AGENT_FILES_BASE64: base64(JSON.stringify(plan.agent.files)),
-    ...beforeAgent.length ? { WORKSPACE_SETUP_COMMAND_BASE64: base64(setupCommandScript(beforeAgent)) } : {},
+    ...beforeAgent.length ? {
+      WORKSPACE_SETUP_COMMAND_BASE64: base64(setupCommandScript(beforeAgent))
+    } : {},
     GITTERM_DIRECT_PROVIDER: "railway"
   };
 }
@@ -1897,7 +1892,7 @@ function createAsciiDirectProvider(config) {
         });
         await runCommand(handle.boxId, `mkdir -p ${shellQuote(directory)}`);
         for (const command of config.runtimeSetupCommands ?? [
-          "npm install -g @opencode/cli@2 --no-audit --fund=false"
+          "npm install -g opencode-ai --no-audit --fund=false"
         ]) {
           await runCommand(handle.boxId, command, undefined, 600);
         }
@@ -2889,7 +2884,7 @@ function createVercelDirectProvider(config) {
       });
       try {
         await run(sandbox, `mkdir -p ${shellQuote(handle.directory)}`);
-        for (const command of config.runtimeSetupCommands ?? (config.image ? [] : ["npm install -g @opencode/cli@2 --no-audit --fund=false"])) {
+        for (const command of config.runtimeSetupCommands ?? (config.image ? [] : ["npm install -g opencode-ai --no-audit --fund=false"])) {
           await run(sandbox, command);
         }
         if (plan.repository) {

package/dist/direct/types.d.ts

@@ -147,7 +147,7 @@ export type DirectWorkspaceCreateInput = {
     /** Trusted integration context appended to the generated global AGENTS.md. */
     additionalAgentInstructions?: string;
     opencode?: {
-        /** Defaults to v2. */
+        /** Defaults to v1. v2 requires a compatible provider image/template. */
         api?: OpencodeApi;
         config?: Record<string, unknown>;
         plugins?: string[];

package/dist/types.d.ts

@@ -63,7 +63,7 @@ export type RunRef = {
     workspaceId: string;
     id: string;
 };
-/** `v1` = OpenCode 1.x (`/event`, `/session/*`); `v2` = OpenCode 2 (`/api/*`) and the default. */
+/** `v1` = OpenCode 1.x (`/event`, `/session/*`) and the default; `v2` = OpenCode 2 (`/api/*`). */
 export type OpencodeApi = "v1" | "v2";
 export type WaitOptions = {
     timeoutMs?: number;
@@ -272,7 +272,8 @@ export type WorkspaceCreateInput = {
          */
         config?: Record<string, unknown>;
         /**
-         * OpenCode API generation served by the image. Defaults to `v2`.
+         * OpenCode API generation served by the image. Defaults to `v1`. Use `v2`
+         * only with an explicitly compatible image.
          */
         api?: OpencodeApi;
     };

package/package.json

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