refactor: extract BaseAdapter from @perstack/core to @perstack/adapter-base

.changeset/extract-base-adapter.md

@@ -0,0 +1,12 @@
+---
+"@perstack/core": patch
+"@perstack/docker": patch
+"@perstack/claude-code": patch
+"@perstack/cursor": patch
+"@perstack/gemini": patch
+"@perstack/runtime": patch
+---
+
+refactor: extract BaseAdapter from @perstack/core to @perstack/adapter-base
+
+This makes @perstack/core client-safe by removing child_process dependency.

apps/runtime/package.json

@@ -41,6 +41,7 @@
     "@ai-sdk/openai": "^2.0.0",
     "@modelcontextprotocol/sdk": "^1.25.1",
     "@paralleldrive/cuid2": "^3.0.4",
+    "@perstack/adapter-base": "workspace:*",
     "@perstack/api-client": "workspace:*",
     "@perstack/base": "workspace:*",
     "@perstack/core": "workspace:*",

apps/runtime/src/perstack-adapter.ts

@@ -1,5 +1,6 @@
 import type { ChildProcess } from "node:child_process"
 import { spawn } from "node:child_process"
+import { BaseAdapter } from "@perstack/adapter-base"
 import type {
   AdapterRunParams,
   AdapterRunResult,
@@ -11,7 +12,7 @@ import type {
   RuntimeEvent,
   RuntimeExpertConfig,
 } from "@perstack/core"
-import { BaseAdapter, checkpointSchema, getFilteredEnv } from "@perstack/core"
+import { checkpointSchema, getFilteredEnv } from "@perstack/core"
 import { findLockfile, loadLockfile } from "./helpers/index.js"
 import { run as perstackRun } from "./run.js"
 

packages/core/src/adapters/index.ts

@@ -1,4 +1,3 @@
-export { BaseAdapter, type ExecResult } from "./base-adapter.js"
 export {
   type CreateCheckpointParams,
   createCallToolsEvent,

packages/runtimes/adapter-base/package.json

@@ -0,0 +1,42 @@
+{
+  "private": true,
+  "version": "0.0.1",
+  "name": "@perstack/adapter-base",
+  "description": "Base adapter class for Perstack runtime adapters",
+  "author": "Wintermute Technologies, Inc.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": {
+        "types": "./dist/src/index.d.ts",
+        "import": "./dist/src/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "pnpm run clean && tsup --config ../../../tsup.config.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@perstack/core": "workspace:*"
+  },
+  "devDependencies": {
+    "@tsconfig/node22": "^22.0.5",
+    "@types/node": "^25.0.3",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.16"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  }
+}

packages/core/src/adapters/base-adapter.ts → packages/runtimes/adapter-base/src/base-adapter.ts

@@ -1,13 +1,13 @@
 import type { ChildProcess } from "node:child_process"
 import { spawn } from "node:child_process"
-import type { Expert } from "../schemas/expert.js"
 import type {
   AdapterRunParams,
   AdapterRunResult,
+  Expert,
   PrerequisiteResult,
   RuntimeAdapter,
   RuntimeExpertConfig,
-} from "./types.js"
+} from "@perstack/core"
 
 export type ExecResult = {
   stdout: string

packages/runtimes/adapter-base/src/index.ts

@@ -0,0 +1 @@
+export { BaseAdapter, type ExecResult } from "./base-adapter.js"

packages/runtimes/adapter-base/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "extends": "@tsconfig/node22/tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": ".",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "moduleResolution": "bundler",
+    "module": "ESNext",
+    "target": "ESNext",
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

packages/runtimes/claude-code/package.json

@@ -28,6 +28,7 @@
   },
   "dependencies": {
     "@paralleldrive/cuid2": "^3.0.4",
+    "@perstack/adapter-base": "workspace:*",
     "@perstack/core": "workspace:*"
   },
   "devDependencies": {

packages/runtimes/claude-code/src/claude-code-adapter.ts

@@ -1,6 +1,7 @@
 import type { ChildProcess } from "node:child_process"
 import { spawn } from "node:child_process"
 import { createId } from "@paralleldrive/cuid2"
+import { BaseAdapter } from "@perstack/adapter-base"
 import type {
   AdapterRunParams,
   AdapterRunResult,
@@ -13,7 +14,6 @@ import type {
   ToolMessage,
 } from "@perstack/core"
 import {
-  BaseAdapter,
   createCallToolsEvent,
   createCompleteRunEvent,
   createEmptyUsage,

packages/runtimes/cursor/package.json

@@ -28,6 +28,7 @@
   },
   "dependencies": {
     "@paralleldrive/cuid2": "^3.0.4",
+    "@perstack/adapter-base": "workspace:*",
     "@perstack/core": "workspace:*"
   },
   "devDependencies": {

packages/runtimes/cursor/src/cursor-adapter.ts

@@ -1,6 +1,7 @@
 import type { ChildProcess } from "node:child_process"
 import { spawn } from "node:child_process"
 import { createId } from "@paralleldrive/cuid2"
+import { BaseAdapter } from "@perstack/adapter-base"
 import type {
   AdapterRunParams,
   AdapterRunResult,
@@ -13,7 +14,6 @@ import type {
   ToolMessage,
 } from "@perstack/core"
 import {
-  BaseAdapter,
   createCallToolsEvent,
   createCompleteRunEvent,
   createEmptyUsage,

packages/runtimes/docker/package.json

@@ -28,6 +28,7 @@
     "test": "vitest run"
   },
   "dependencies": {
+    "@perstack/adapter-base": "workspace:*",
     "@perstack/core": "workspace:*",
     "smol-toml": "^1.5.2"
   },

packages/runtimes/docker/src/docker-adapter.ts

@@ -2,6 +2,7 @@ import type { ChildProcess, SpawnOptions } from "node:child_process"
 import * as fs from "node:fs"
 import * as os from "node:os"
 import * as path from "node:path"
+import { BaseAdapter } from "@perstack/adapter-base"
 import type {
   AdapterRunParams,
   AdapterRunResult,
@@ -13,7 +14,7 @@ import type {
   RuntimeEvent,
   RuntimeExpertConfig,
 } from "@perstack/core"
-import { BaseAdapter, createRuntimeEvent } from "@perstack/core"
+import { createRuntimeEvent } from "@perstack/core"
 import { generateBuildContext } from "./compose-generator.js"
 import { extractRequiredEnvVars, resolveEnvValues } from "./env-resolver.js"
 import { selectBuildStrategy } from "./lib/build-strategy.js"

packages/runtimes/docker/src/lib/build-strategy.ts

@@ -1,5 +1,6 @@
 import * as path from "node:path"
-import type { ExecResult, RunEvent, RuntimeEvent } from "@perstack/core"
+import type { ExecResult } from "@perstack/adapter-base"
+import type { RunEvent, RuntimeEvent } from "@perstack/core"
 import { createRuntimeEvent } from "@perstack/core"
 import { parseBuildOutputLine } from "./output-parser.js"
 import type { ProcessFactory } from "./process-factory.js"

packages/runtimes/docker/src/lib/test-utils.ts

@@ -1,6 +1,7 @@
 import type { ChildProcess, SpawnOptions } from "node:child_process"
 import { EventEmitter } from "node:events"
-import type { ExecResult, RunEvent, RuntimeEvent } from "@perstack/core"
+import type { ExecResult } from "@perstack/adapter-base"
+import type { RunEvent, RuntimeEvent } from "@perstack/core"
 import { vi } from "vitest"
 import { DockerAdapter } from "../docker-adapter.js"
 import type { ProcessFactory } from "./process-factory.js"

packages/runtimes/gemini/package.json

@@ -28,6 +28,7 @@
   },
   "dependencies": {
     "@paralleldrive/cuid2": "^3.0.4",
+    "@perstack/adapter-base": "workspace:*",
     "@perstack/core": "workspace:*"
   },
   "devDependencies": {

packages/runtimes/gemini/src/gemini-adapter.ts

@@ -1,6 +1,7 @@
 import type { ChildProcess } from "node:child_process"
 import { spawn } from "node:child_process"
 import { createId } from "@paralleldrive/cuid2"
+import { BaseAdapter } from "@perstack/adapter-base"
 import type {
   AdapterRunParams,
   AdapterRunResult,
@@ -13,7 +14,6 @@ import type {
   ToolMessage,
 } from "@perstack/core"
 import {
-  BaseAdapter,
   createCallToolsEvent,
   createCompleteRunEvent,
   createEmptyUsage,