@pantheon.ai/mcp 0.0.1

package/.idea/compiler.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="TypeScriptCompiler">
+    <option name="useServicePoweredTypesEnabledManually" value="true" />
+  </component>
+</project>

package/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/pantheon-mcp.iml" filepath="$PROJECT_DIR$/.idea/pantheon-mcp.iml" />
+    </modules>
+  </component>
+</project>

package/.idea/pantheon-mcp.iml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="WEB_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

package/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$" vcs="Git" />
+  </component>
+</project>

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@pantheon.ai/mcp",
+  "version": "0.0.1",
+  "type": "module",
+  "description": "",
+  "bin": "src/index.ts",
+  "scripts": {
+    "postinstall": "patch-package"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/inspector": "^0.19.0",
+    "@types/express": "^5.0.6",
+    "@types/node": "^24.10.10",
+    "ai": "6.0.45",
+    "patch-package": "^8.0.1",
+    "typescript": "^5.5.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "workspaces": [
+    "packages/sdk"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "express": "^5.2.1",
+    "zod": "^4.3.6"
+  }
+}

package/packages/sdk/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@pantheon/sdk",
+  "version": "0.0.0",
+  "type": "module",
+  "dependencies": {
+    "url-template": "^3.1.1",
+    "zod": "^4.1.9"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.2"
+  },
+  "exports": {
+    ".": "./src/index.ts",
+    "./*": "./src/*.ts"
+  }
+}

package/packages/sdk/src/api/auth.ts

@@ -0,0 +1,22 @@
+import { defineApi, get, post, typeOf } from "@pantheon/sdk/lib/api"
+import { z } from "zod"
+
+export const login = defineApi(
+  post`/api/v1/auth/login`,
+  typeOf<FormData>(),
+  "raw"
+)
+
+export const logout = defineApi(post`/api/v1/auth/logout`, null, "raw")
+
+export const getMe = defineApi(
+  get`/api/v1/users/me`,
+  null,
+  z.object({
+    id: z.string(),
+    email: z.string(),
+    is_active: z.boolean(),
+    is_superuser: z.boolean(),
+    is_verified: z.boolean(),
+  })
+)

package/packages/sdk/src/api/connectors.ts

@@ -0,0 +1,27 @@
+import { defineApi, get } from "@pantheon/sdk/lib/api"
+import { paged } from "@pantheon/sdk/schemas/common"
+
+import { z } from "zod"
+
+export const getGithubUser = defineApi(
+  get`/api/v1/connectors/github/user`,
+  null,
+  z
+    .object({
+      github_username: z.string(),
+    })
+    .nullable()
+)
+
+export const listGithubRepositories = defineApi(
+  get`/api/v1/user/github/repositories?page=${"page"}&size=${"size"}`,
+  null,
+  paged(
+    z.object({
+      repo_id: z.number(),
+      repo_name: z.string(),
+      public: z.boolean(),
+      installation_id: z.number(),
+    })
+  )
+)

package/packages/sdk/src/api/environments.ts

@@ -0,0 +1,53 @@
+import { defineApi, del, get, post, put, typeOf } from "@pantheon/sdk/lib/api"
+import { paged } from "@pantheon/sdk/schemas/common"
+import {
+  environmentDeleteSchema,
+  environmentSchema,
+} from "@pantheon/sdk/schemas/environments"
+
+export const listEnvironments = defineApi(
+  get`/api/v1/admin/environments?page=${"page"}&size=${"size"}&id=${"id?"}&name=${"name?"}&display_name=${"display_name?"}&repo_name=${"repo_name?"}&repo_id=${"repo_id?"}&query=${"query?"}`,
+  null,
+  paged(environmentSchema)
+)
+
+export const getEnvironment = defineApi(
+  get`/api/v1/admin/environments/${"environmentId"}`,
+  null,
+  environmentSchema
+)
+
+export const createEnvironment = defineApi(
+  post`/api/v1/admin/environments`,
+  typeOf<{
+    name: string
+    display_name?: string
+    description?: string
+    base_image_ref?: string
+    seed_snap_id?: string
+    repo_name?: string
+    repo_id?: number
+    source_branch_id?: string
+  }>(),
+  environmentSchema
+)
+
+export const updateEnvironment = defineApi(
+  put`/api/v1/admin/environments/${"environmentId"}`,
+  typeOf<{
+    name?: string
+    display_name?: string
+    description?: string
+    base_image_ref?: string
+    seed_snap_id?: string
+    repo_name?: string
+    repo_id?: number | null
+  }>(),
+  environmentSchema
+)
+
+export const deleteEnvironment = defineApi(
+  del`/api/v1/admin/environments/${"environmentId"}`,
+  null,
+  environmentDeleteSchema
+)

package/packages/sdk/src/api/projects.ts

@@ -0,0 +1,143 @@
+import { defineApi, del, get, post, typeOf } from "@pantheon/sdk/lib/api"
+import { branchSchema, branchSnapsSchema } from "@pantheon/sdk/schemas/branch"
+import { paged } from "@pantheon/sdk/schemas/common"
+import {
+  explorationResultSchema,
+  explorationSchema,
+} from "@pantheon/sdk/schemas/exploration"
+
+import { FSResponseValidator } from "@pantheon/sdk/schemas/fs"
+import {
+  projectBackgroundTaskSchema,
+  projectMessageSchema,
+  projectSchema,
+} from "@pantheon/sdk/schemas/project"
+import { z } from "zod"
+
+export const listProjects = defineApi(
+  get`/api/v1/projects?page=${"page"}&size=${"size"}&user_id=${"user_id?"}&category=${"category?"}`,
+  null,
+  paged(projectSchema)
+)
+
+export const getProject = defineApi(
+  get`/api/v1/projects/${"projectId"}`,
+  null,
+  projectSchema
+)
+
+export const createProject = defineApi(
+  post`/api/v1/projects`,
+  typeOf<{
+    first_prompt: string
+    project_type: "general" | "github"
+    github_repo_id?: number
+    github_installation_id?: number
+    env_id?: string
+  }>(),
+  projectSchema
+)
+
+export const listProjectMessages = defineApi(
+  get`/api/v1/projects/${"projectId"}/messages`,
+  null,
+  z.object({
+    messages: projectMessageSchema.array(),
+    ongoing_stream_id: z.string().nullable(),
+  })
+)
+
+export const deleteProjectMessage = defineApi(
+  del`/api/v1/projects/${"projectId"}/messages/${"messageId"}`,
+  null,
+  "raw" as const
+)
+
+export const postProjectMessage = defineApi(
+  post`/api/v1/projects/${"projectId"}`,
+  typeOf<{
+    prompt: string
+    selected_branches?: string[]
+  }>(),
+  z.object({
+    messages: projectMessageSchema.array(),
+    ongoing_stream_id: z.string().nullable(),
+  })
+)
+
+export const continueProject = defineApi(
+  post`/api/v1/projects/${"projectId"}/continue`,
+  typeOf<{}>(),
+  "raw" as const
+)
+
+export const stopProject = defineApi(
+  post`/api/v1/projects/${"projectId"}/stop`,
+  typeOf<{}>(),
+  "raw" as const
+)
+
+export const getProjectBranch = defineApi(
+  get`/api/v1/projects/${"projectId"}/branches/${"branchId"}`,
+  null,
+  branchSchema
+)
+
+export const getProjectBranchOutput = defineApi(
+  get`/api/v1/projects/${"projectId"}/branches/${"branchId"}/output?full_output=${"fullOutput?"}`,
+  null,
+  z.string()
+)
+
+export const listProjectBranches = defineApi(
+  get`/api/v1/projects/${"projectId"}/branches?page=${"page"}&size=${"size"}`,
+  null,
+  paged(branchSchema)
+)
+
+export const listProjectBranchSnaps = defineApi(
+  get`/api/v1/projects/${"projectId"}/branches/${"branchId"}/snaps`,
+  null,
+  branchSnapsSchema
+)
+
+export const listProjectBackgroundTasks = defineApi(
+  get`/api/v1/projects/${"projectId"}/background_tasks?statuses=${"statuses?"}`,
+  null,
+  z.array(projectBackgroundTaskSchema)
+)
+
+export const createProjectExploration = defineApi(
+  post`/api/v1/projects/${"projectId"}/explorations`,
+  typeOf<{
+    parent_branch_id: string
+    shared_prompt_sequence: string[] // 1 - 4
+    num_branches?: number // default 3, 1 - 50
+    agent?: string
+  }>(),
+  explorationSchema
+)
+
+export const listProjectExplorations = defineApi(
+  get`/api/v1/projects/${"projectId"}/explorations`,
+  null,
+  explorationSchema.array()
+)
+
+export const getProjectExplorationResult = defineApi(
+  get`/api/v1/projects/${"projectId"}/explorations/${"explorationId"}/result`,
+  null,
+  explorationResultSchema
+)
+
+export const getProjectBranchFs = defineApi(
+  get`/api/v1/projects/${"projectId"}/branches/${"branchId"}/fs/${"path*"}`,
+  null,
+  FSResponseValidator
+)
+
+export const getProjectBranchFsPreview = defineApi(
+  get`/api/v1/projects/${"projectId"}/branches/${"branchId"}/preview/${"path*"}`,
+  null,
+  FSResponseValidator
+)

package/packages/sdk/src/api/stream-proxy.ts

@@ -0,0 +1,17 @@
+import { defineApi, get } from "@pantheon/sdk/lib/api"
+import {
+  projectMessageStreamParser,
+  projectRawMessageStreamParser,
+} from "@pantheon/sdk/schemas/project"
+
+export const readMessageStream = defineApi(
+  get`/ai_stream_proxy/v2/streams/${"streamId"}/stream?format=vercel-ai-ui-message-stream-v1&skip=${"skip?"}`,
+  null,
+  projectMessageStreamParser
+)
+
+export const readRawMessageStream = defineApi(
+  get`/ai_stream_proxy/v2/streams/${"streamId"}/stream?format=opaque-stream-json`,
+  null,
+  projectRawMessageStreamParser
+)

package/packages/sdk/src/index.ts

@@ -0,0 +1,16 @@
+export type { PrimitiveValue } from "url-template"
+export type { Api } from "@pantheon/sdk/lib/api"
+
+export * from "@pantheon/sdk/api/projects"
+export * from "@pantheon/sdk/api/connectors"
+export * from "@pantheon/sdk/api/stream-proxy"
+export * from "@pantheon/sdk/lib/vercel-ai-hack"
+
+export type {
+  MessageMetadata,
+  Tools,
+  DataTypes,
+  MasterAgentMessage,
+  MasterAgentMessageChunk,
+  MasterAgentMessagePart,
+} from "@pantheon/sdk/schemas/ai"

package/packages/sdk/src/lib/api-executor.ts

@@ -0,0 +1,169 @@
+import type {
+  Api,
+  ApiParams,
+  ApiRequestBody,
+  ApiResponseBody,
+} from "@pantheon/sdk/lib/api"
+import { type PrimitiveValue } from "url-template"
+
+export interface ApiExecutor {
+  execute<API extends Api<any, any, any, any>>(
+    api: API,
+    params: ApiParams<API>,
+    body: ApiRequestBody<API> extends void ? null : ApiRequestBody<API>,
+    requestInit?: Omit<RequestInit, "method" | "body">
+  ): Promise<ApiResponseBody<API>>
+
+  onError(
+    callback: (error: unknown, context: ApiExecutorContext) => void
+  ): () => void
+}
+
+export interface ApiExecutorContext {
+  readonly api: Api<any, any, any, any>
+  readonly params: any
+  readonly requestBody: any
+  readonly url: string
+  readonly request: Request
+}
+
+export class ApiError extends Error {
+  public readonly response: Response
+  public readonly context: ApiExecutorContext
+  public readonly responseBody: any
+
+  constructor(
+    response: Response,
+    context: ApiExecutorContext,
+    responseBody: any
+  ) {
+    super(
+      `${context.request.method} ${context.url}: ${response.status} ${response.statusText} ${getServerErrorMessage(responseBody)}`
+    )
+    this.response = response
+    this.context = context
+    this.responseBody = responseBody
+  }
+}
+
+export interface ApiExecutorOptions {
+  baseUrl?: string
+  headers?: HeadersInit
+  validateResponse: (
+    response: Response,
+    context: ApiExecutorContext
+  ) => void | Promise<void>
+}
+
+export function createApiExecutor({
+  baseUrl,
+  headers,
+  validateResponse,
+}: ApiExecutorOptions): Readonly<ApiExecutor> {
+  const errorCallbacks: ((
+    error: unknown,
+    context: ApiExecutorContext
+  ) => void)[] = []
+
+  function onError(
+    callback: (error: unknown, context: ApiExecutorContext) => void
+  ): () => void {
+    errorCallbacks.push(callback)
+
+    return () => {
+      const index = errorCallbacks.indexOf(callback)
+      if (index !== -1) {
+        errorCallbacks.splice(index, 1)
+      }
+    }
+  }
+
+  async function execute<
+    Params extends Record<string, PrimitiveValue> | null,
+    RequestBody,
+    ResponseBody,
+  >(
+    api: Api<any, Params, RequestBody, ResponseBody>,
+    params: Params,
+    requestBody: RequestBody,
+    requestInit?: Omit<RequestInit, "method" | "body" | "headers">
+  ): Promise<ResponseBody> {
+    const url = baseUrl
+      ? new URL(api.url(params as any), baseUrl).toString()
+      : api.url(params as any)
+    const { headers: initHeaders, ...init } = api.requestInit(requestBody)
+
+    const executorHeaders = new Headers(headers)
+    if (initHeaders) {
+      new Headers(initHeaders).forEach((value, key) => {
+        executorHeaders.set(key, value)
+      })
+    }
+    const request = new Request(url, {
+      ...requestInit,
+      ...init,
+      headers: executorHeaders,
+      credentials: "include",
+    })
+
+    const context = Object.freeze({ api, params, requestBody, url, request })
+    try {
+      const response = await fetch(request)
+      await validateResponse(response, context)
+      return await api.handleResponse(response, context)
+    } catch (error) {
+      for (const callback of errorCallbacks) {
+        callback(error, context)
+      }
+      return Promise.reject(error)
+    }
+  }
+
+  return Object.freeze({
+    execute,
+    onError,
+  })
+}
+
+export async function validateResponse(
+  response: Response,
+  context: ApiExecutorContext
+) {
+  if (!response.ok) {
+    const responseBody = await response
+      .clone()
+      .json()
+      .catch(() => response.clone().text())
+      .catch(() => undefined)
+
+    throw new ApiError(response, context, responseBody)
+  }
+}
+
+function getServerErrorMessage(error: any): string {
+  if (error == null) {
+    return "No error message."
+  }
+
+  if (typeof error === "string") {
+    return error
+  }
+
+  if (typeof error === "object") {
+    for (const key of [
+      "message",
+      "error",
+      "errMsg",
+      "errorMsg",
+      "detail",
+      "details",
+    ]) {
+      if (key in error) {
+        return String(error[key])
+      }
+    }
+    return JSON.stringify(error, undefined, 2)
+  }
+
+  return String(error)
+}