@treeseed/sdk 0.10.11 → 0.10.13

package/dist/market-client.js

@@ -272,7 +272,8 @@ class MarketClient {
     });
     const payload = await response.json().catch(() => ({}));
     if (!response.ok) {
-      const error = typeof payload.error === "string" ? String(payload.error) : `Market request failed with ${response.status}.`;
+      const payloadError = payload.error;
+      const error = typeof payloadError === "string" ? String(payloadError) : payloadError && typeof payloadError === "object" && typeof payloadError.message === "string" ? String(payloadError.message) : `Market request failed with ${response.status}.`;
       throw new MarketApiError(error, response.status, payload);
     }
     return payload;
@@ -331,11 +332,45 @@ class MarketClient {
       body
     });
   }
+  confirmWebEmail(body) {
+    return this.request("/v1/auth/web/confirm-email", {
+      method: "POST",
+      body
+    });
+  }
   checkWebUsername(username) {
     return this.request(
       `/v1/auth/web/username/check?username=${encodeURIComponent(username)}`
     );
   }
+  webEmails() {
+    return this.request("/v1/auth/web/emails", { requireAuth: true });
+  }
+  addWebEmail(body) {
+    return this.request("/v1/auth/web/emails", {
+      method: "POST",
+      body,
+      requireAuth: true
+    });
+  }
+  verifyWebEmail(emailId) {
+    return this.request(
+      `/v1/auth/web/emails/${encodeURIComponent(emailId)}/verify`,
+      { method: "POST", requireAuth: true }
+    );
+  }
+  setPrimaryWebEmail(emailId) {
+    return this.request(
+      `/v1/auth/web/emails/${encodeURIComponent(emailId)}/primary`,
+      { method: "POST", requireAuth: true }
+    );
+  }
+  deleteWebEmail(emailId) {
+    return this.request(
+      `/v1/auth/web/emails/${encodeURIComponent(emailId)}`,
+      { method: "DELETE", requireAuth: true }
+    );
+  }
   webSessions() {
     return this.request("/v1/auth/web/sessions", { requireAuth: true });
   }
@@ -426,12 +461,73 @@ class MarketClient {
       { requireAuth: true }
     );
   }
+  projectDeploymentState(projectId) {
+    return this.request(
+      `/v1/projects/${encodeURIComponent(projectId)}/deployment-state`,
+      { requireAuth: true }
+    );
+  }
+  projectDeployments(projectId, filters = {}) {
+    const query = new URLSearchParams();
+    if (filters.environment) query.set("environment", String(filters.environment));
+    if (filters.action) query.set("action", String(filters.action));
+    if (filters.status) query.set("status", String(filters.status));
+    if (filters.limit) query.set("limit", String(filters.limit));
+    const suffix = query.size > 0 ? `?${query.toString()}` : "";
+    return this.request(
+      `/v1/projects/${encodeURIComponent(projectId)}/deployments${suffix}`,
+      { requireAuth: true }
+    );
+  }
+  projectDeployment(projectId, deploymentId) {
+    return this.request(
+      `/v1/projects/${encodeURIComponent(projectId)}/deployments/${encodeURIComponent(deploymentId)}`,
+      { requireAuth: true }
+    );
+  }
+  projectDeploymentEvents(projectId, deploymentId, options = {}) {
+    const query = options.limit ? `?limit=${encodeURIComponent(String(options.limit))}` : "";
+    return this.request(
+      `/v1/projects/${encodeURIComponent(projectId)}/deployments/${encodeURIComponent(deploymentId)}/events${query}`,
+      { requireAuth: true }
+    );
+  }
+  createProjectWebDeployment(projectId, body) {
+    return this.request(
+      `/v1/projects/${encodeURIComponent(projectId)}/deployments/web`,
+      { method: "POST", body, requireAuth: true }
+    );
+  }
+  retryProjectDeployment(projectId, deploymentId, body = {}) {
+    return this.request(
+      `/v1/projects/${encodeURIComponent(projectId)}/deployments/${encodeURIComponent(deploymentId)}/retry`,
+      { method: "POST", body, requireAuth: true }
+    );
+  }
+  resumeProjectDeployment(projectId, deploymentId, body = {}) {
+    return this.request(
+      `/v1/projects/${encodeURIComponent(projectId)}/deployments/${encodeURIComponent(deploymentId)}/resume`,
+      { method: "POST", body, requireAuth: true }
+    );
+  }
+  cancelProjectDeployment(projectId, deploymentId, body = {}) {
+    return this.request(
+      `/v1/projects/${encodeURIComponent(projectId)}/deployments/${encodeURIComponent(deploymentId)}/cancel`,
+      { method: "POST", body, requireAuth: true }
+    );
+  }
   teamCapacity(teamId) {
     return this.request(
       `/v1/teams/${encodeURIComponent(teamId)}/capacity`,
       { requireAuth: true }
     );
   }
+  teamCapacityProviders(teamId) {
+    return this.request(
+      `/v1/teams/${encodeURIComponent(teamId)}/capacity-providers`,
+      { requireAuth: true }
+    );
+  }
   launchManagedCapacityProvider(teamId, body = {}) {
     return this.request(
       `/v1/teams/${encodeURIComponent(teamId)}/capacity/providers/managed`,
@@ -456,12 +552,49 @@ class MarketClient {
       { requireAuth: true }
     );
   }
+  updateCapacityProvider(teamId, providerId, body) {
+    return this.request(
+      `/v1/teams/${encodeURIComponent(teamId)}/capacity-providers/${encodeURIComponent(providerId)}`,
+      { method: "PATCH", body, requireAuth: true }
+    );
+  }
   createCapacityGrant(teamId, body) {
     return this.request(
       `/v1/teams/${encodeURIComponent(teamId)}/capacity-grants`,
       { method: "POST", body, requireAuth: true }
     );
   }
+  executionProviders(teamId, providerId) {
+    return this.request(
+      `/v1/teams/${encodeURIComponent(teamId)}/capacity-providers/${encodeURIComponent(providerId)}/execution-providers`,
+      { requireAuth: true }
+    );
+  }
+  createExecutionProvider(teamId, providerId, body) {
+    return this.request(
+      `/v1/teams/${encodeURIComponent(teamId)}/capacity-providers/${encodeURIComponent(providerId)}/execution-providers`,
+      { method: "POST", body, requireAuth: true }
+    );
+  }
+  updateExecutionProvider(teamId, providerId, executionProviderId, body) {
+    return this.request(
+      `/v1/teams/${encodeURIComponent(teamId)}/capacity-providers/${encodeURIComponent(providerId)}/execution-providers/${encodeURIComponent(executionProviderId)}`,
+      { method: "PATCH", body, requireAuth: true }
+    );
+  }
+  createExecutionProviderNativeLimit(teamId, providerId, executionProviderId, body) {
+    return this.request(
+      `/v1/teams/${encodeURIComponent(teamId)}/capacity-providers/${encodeURIComponent(providerId)}/execution-providers/${encodeURIComponent(executionProviderId)}/native-limits`,
+      { method: "POST", body, requireAuth: true }
+    );
+  }
+  projectCapacityPlan(projectId, environment) {
+    const query = environment ? `?environment=${encodeURIComponent(environment)}` : "";
+    return this.request(
+      `/v1/projects/${encodeURIComponent(projectId)}/capacity-plan${query}`,
+      { requireAuth: true }
+    );
+  }
   planSeed(seedName, body) {
     return this.request(
       `/v1/seeds/${encodeURIComponent(seedName)}/plan`,

package/dist/operations/services/commit-message-provider.js

@@ -62,7 +62,7 @@ function changedPaths(changedFiles) {
 function changedFileGroups(paths) {
   const counts = /* @__PURE__ */ new Map();
   for (const path of paths) {
-    const group = path.startsWith(".github/") || path.includes("/workflows/") ? "ci" : /(^|\/)(test|tests|__tests__)\/|\.test\.|\.spec\./u.test(path) ? "tests" : path.startsWith("docs/") || /\.(md|mdx|txt)$/u.test(path) ? "docs" : path.includes("workflow") || path.includes("repository-save-orchestrator") ? "workflow" : path.includes("package-reference") || path.includes("release") || path.includes("publish") ? "release" : /(^|\/)(package|package-lock)\.json$/u.test(path) || path.includes("build") || path.includes("scripts/") ? "build" : path.includes("config") || path.endsWith(".yaml") || path.endsWith(".yml") ? "config" : path.startsWith("migrations/") || path.includes("/db/") ? "database" : path.startsWith("src/pages/") || path.startsWith("src/layouts/") || path.includes("/ui/") ? "ui" : path.startsWith("src/api/") || path.includes("/api/") ? "api" : "source";
+    const group = path.startsWith(".github/") || path.includes("/workflows/") ? "ci" : /(^|\/)(test|tests|__tests__)\/|\.test\.|\.spec\./u.test(path) ? "tests" : path.startsWith("docs/") || /\.(md|mdx|txt)$/u.test(path) ? "docs" : path.includes("workflow") || path.includes("repository-save-orchestrator") ? "workflow" : path.includes("package-reference") || path.includes("release") || path.includes("publish") ? "release" : /(^|\/)(package|package-lock)\.json$/u.test(path) || path.includes("build") || path.includes("scripts/") ? "build" : path.includes("config") || path.endsWith(".yaml") || path.endsWith(".yml") ? "config" : path.startsWith("packages/sdk/drizzle/") || path.includes("/db/") ? "database" : path.startsWith("src/pages/") || path.startsWith("src/layouts/") || path.includes("/ui/") ? "ui" : path.startsWith("src/api/") || path.includes("/api/") ? "api" : "source";
     counts.set(group, (counts.get(group) ?? 0) + 1);
   }
   return [...counts.entries()].sort((left, right) => right[1] - left[1] || left[0].localeCompare(right[0]));

package/dist/operations/services/d1-migration.js

@@ -1,8 +1,6 @@
 import { existsSync, readdirSync } from "node:fs";
-import { readFileSync } from "node:fs";
 import { resolve } from "node:path";
 import { spawnSync } from "node:child_process";
-import { NodeSqliteD1Database } from "../../db/node-sqlite.js";
 import { resolveWranglerBin } from "./runtime-tools.js";
 const DATABASE_BINDING = "SITE_DATA_DB";
 const WRANGLER_D1_TIMEOUT_MS = 12e4;
@@ -100,58 +98,6 @@ function markMigrationApplied({ cwd, wranglerConfig, persistTo, migration }) {
     command: `INSERT OR REPLACE INTO treeseed_schema_migrations (name, applied_at) VALUES ('${migration.replace(/'/g, "''")}', datetime('now'));`
   });
 }
-function tableColumns({ cwd, wranglerConfig, persistTo, tableName }) {
-  const result = executeSqlCommand({
-    cwd,
-    wranglerConfig,
-    persistTo,
-    capture: true,
-    command: `PRAGMA table_info(${tableName.replace(/[^A-Za-z0-9_]/g, "")});`
-  });
-  const parsed = parseWranglerJsonOutput(result.stdout);
-  const rows = (Array.isArray(parsed) ? parsed : [parsed]).flatMap((entry) => entry.results ?? []);
-  return new Set(rows.map((row) => row.name).filter(Boolean));
-}
-function migrationAlreadySatisfied({ cwd, wranglerConfig, persistTo, filePath }) {
-  const sql = readFileSync(filePath, "utf8");
-  if (!sql.includes("execution_profile_id") || !sql.includes("task_estimate_profiles")) {
-    return false;
-  }
-  const estimateColumns = tableColumns({ cwd, wranglerConfig, persistTo, tableName: "task_estimates" });
-  const actualColumns = tableColumns({ cwd, wranglerConfig, persistTo, tableName: "task_usage_actuals" });
-  const profileColumns = tableColumns({ cwd, wranglerConfig, persistTo, tableName: "task_estimate_profiles" });
-  return estimateColumns.has("execution_profile_id") && actualColumns.has("execution_profile_id") && profileColumns.has("execution_profile_id") && profileColumns.has("completed_sample_count") && profileColumns.has("interrupted_sample_count") && profileColumns.has("confidence_score");
-}
-function ensureLocalSdkRuntimeState({ migrationsRoot, persistTo }) {
-  if (!persistTo) {
-    return;
-  }
-  const migrationPath = resolve(migrationsRoot, "0025_agent_runtime_state.sql");
-  if (!existsSync(migrationPath)) {
-    return;
-  }
-  const sql = readFileSync(migrationPath, "utf8");
-  const targets = /* @__PURE__ */ new Set();
-  const sdkDb = new NodeSqliteD1Database(persistTo);
-  targets.add(sdkDb.path);
-  sdkDb.close();
-  const miniflareRoot = resolve(persistTo, "miniflare-D1DatabaseObject");
-  if (existsSync(miniflareRoot)) {
-    for (const entry of readdirSync(miniflareRoot)) {
-      if (entry.endsWith(".sqlite") && entry !== "metadata.sqlite") {
-        targets.add(resolve(miniflareRoot, entry));
-      }
-    }
-  }
-  for (const target of targets) {
-    const db = new NodeSqliteD1Database(target);
-    try {
-      db.client.exec(sql);
-    } finally {
-      db.close();
-    }
-  }
-}
 function runLocalD1Migrations({ cwd, wranglerConfig, migrationsRoot, persistTo }) {
   ensureSchemaMigrationsTable({ cwd, wranglerConfig, persistTo });
   const appliedMigrations = loadAppliedMigrations({ cwd, wranglerConfig, persistTo });
@@ -165,14 +111,9 @@ function runLocalD1Migrations({ cwd, wranglerConfig, migrationsRoot, persistTo }
       console.error(`Unable to find migration file at ${filePath}.`);
       process.exit(1);
     }
-    if (migrationAlreadySatisfied({ cwd, wranglerConfig, persistTo, filePath })) {
-      markMigrationApplied({ cwd, wranglerConfig, persistTo, migration });
-      continue;
-    }
     executeSqlFile({ cwd, wranglerConfig, filePath, persistTo });
     markMigrationApplied({ cwd, wranglerConfig, persistTo, migration });
   }
-  ensureLocalSdkRuntimeState({ migrationsRoot, persistTo });
 }
 export {
   runLocalD1Migrations

package/dist/operations/services/deploy.js

@@ -6,6 +6,7 @@ import { createInterface } from "node:readline/promises";
 import { resolveTreeseedWebCachePolicy } from "../../platform/deploy-config.js";
 import { normalizeRailwayEnvironmentName } from "./railway-api.js";
 import { loadCliDeployConfig, resolveWranglerBin } from "./runtime-tools.js";
+import { sdkD1MigrationsRoot } from "./runtime-paths.js";
 const DEFAULT_COMPATIBILITY_DATE = "2026-04-05";
 const DEFAULT_COMPATIBILITY_FLAGS = ["nodejs_compat"];
 const DEFAULT_TREESEED_MARKET_BASE_URL = "https://api.treeseed.ai";
@@ -339,7 +340,10 @@ const LOCAL_RUNTIME_AUTH_ENV_KEYS = [
   "TREESEED_API_DEVICE_CODE_TTL",
   "TREESEED_API_DEVICE_ACCESS_TOKEN_TTL",
   "TREESEED_API_DEVICE_POLL_INTERVAL",
+  "TREESEED_API_WEB_SERVICE_ID",
+  "TREESEED_API_WEB_SERVICE_SECRET",
   "TREESEED_API_WEB_EXCHANGE_TTL",
+  "TREESEED_PLATFORM_RUNNER_SECRET",
   "TREESEED_AUTH_GITHUB_CLIENT_ID",
   "TREESEED_AUTH_GITHUB_CLIENT_SECRET",
   "TREESEED_AUTH_GOOGLE_CLIENT_ID",
@@ -737,7 +741,7 @@ function buildWranglerConfigContents(tenantRoot, deployConfig, state, options =
   const workerName = state.workerName ?? targetWorkerName(deployConfig, target);
   const mainPath = relativeFromGeneratedRoot(resolve(tenantRoot, "dist/_worker.js/index.js"), generatedRoot);
   const assetsDirectory = relativeFromGeneratedRoot(resolve(tenantRoot, "dist"), generatedRoot);
-  const migrationsDir = relativeFromGeneratedRoot(resolve(tenantRoot, "migrations"), generatedRoot);
+  const migrationsDir = relativeFromGeneratedRoot(sdkD1MigrationsRoot, generatedRoot);
   const vars = {
     ...buildPublicVars(deployConfig),
     ...buildLocalRuntimeVars(deployConfig, state, target, options.env)

package/dist/operations/services/github-api.d.ts

@@ -58,6 +58,59 @@ export type GitHubWorkflowProgressEvent = {
     completedJobs?: GitHubWorkflowJobSummary[];
     failedJobs?: GitHubWorkflowJobSummary[];
 };
+export interface GitHubWorkflowDispatchResult {
+    repository: string;
+    workflow: string;
+    branch: string;
+    inputs: Record<string, string> | undefined;
+    status: number | null;
+    dispatchedAt: string;
+}
+export interface GitHubWorkflowCancellationResult {
+    ok: boolean;
+    supported: boolean;
+    repository: string | null;
+    runId: number | null;
+    url?: string | null;
+    message: string;
+    cancelledAt?: string | null;
+}
+export interface GitHubWorkflowFileStatus {
+    ok: boolean;
+    exists: boolean | null;
+    repository: string;
+    workflow: string;
+    url: string | null;
+    message: string;
+}
+export interface GitHubWorkflowFailureSummaryInput {
+    repository?: string | null;
+    workflow?: string | null;
+    runId?: number | string | null;
+    runUrl?: string | null;
+    conclusion?: string | null;
+    failedJobName?: string | null;
+    lastActiveStep?: string | null;
+    message?: string | null;
+    blockerCode?: string | null;
+    retrySafe?: boolean;
+    resumeSafe?: boolean;
+}
+export interface GitHubWorkflowFailureSummary {
+    summary: string;
+    provider: 'github';
+    repository: string | null;
+    workflow: string | null;
+    runId: number | null;
+    runUrl: string | null;
+    inspectCommand: string | null;
+    failedJobName: string | null;
+    lastActiveStep: string | null;
+    conclusion: string | null;
+    retrySafe: boolean;
+    resumeSafe: boolean;
+    blockerCode: string;
+}
 export declare function resolveGitHubApiToken(env?: NodeJS.ProcessEnv | Record<string, string | undefined>): string;
 export declare function parseGitHubRepositorySlug(value: string): {
     owner: string;
@@ -147,6 +200,36 @@ export declare function upsertGitHubRepositoryVariableWithGhCli(repository: stri
 }, name: string, value: string, { env, }?: {
     env?: NodeJS.ProcessEnv | Record<string, string | undefined>;
 }): void;
+export declare function formatGitHubWorkflowFailure(input?: GitHubWorkflowFailureSummaryInput): GitHubWorkflowFailureSummary;
+export declare function dispatchGitHubWorkflowRun(repository: string | {
+    owner: string;
+    name: string;
+}, { client, workflow, branch, inputs, }: {
+    client?: GitHubApiClient;
+    workflow?: string;
+    branch: string;
+    inputs?: Record<string, string>;
+}): Promise<GitHubWorkflowDispatchResult>;
+export declare function cancelGitHubWorkflowRun(repository: string | {
+    owner: string;
+    name: string;
+} | null | undefined, runId: number | string | null | undefined, { client }?: {
+    client?: GitHubApiClient;
+}): Promise<GitHubWorkflowCancellationResult>;
+export declare function getGitHubWorkflowFileStatus(repository: string | {
+    owner: string;
+    name: string;
+}, workflow?: string, { client }?: {
+    client?: GitHubApiClient;
+}): Promise<GitHubWorkflowFileStatus>;
+export declare function getLatestGitHubWorkflowRun(repository: string | {
+    owner: string;
+    name: string;
+}, { client, workflow, branch, }?: {
+    client?: GitHubApiClient;
+    workflow?: string;
+    branch?: string | null;
+}): Promise<GitHubWorkflowRunSummary | null>;
 export declare function waitForGitHubWorkflowRunCompletion(repository: string | {
     owner: string;
     name: string;

package/dist/operations/services/github-api.js

@@ -548,6 +548,168 @@ function normalizeWorkflowJob(job) {
     })) : []
   };
 }
+function workflowInspectCommand(repository, runId) {
+  return repository && runId ? `gh run view ${runId} --repo ${repository} --log-failed` : null;
+}
+function formatGitHubWorkflowFailure(input = {}) {
+  const repository = typeof input.repository === "string" && input.repository.trim() ? input.repository.trim() : null;
+  const workflow = typeof input.workflow === "string" && input.workflow.trim() ? input.workflow.trim() : null;
+  const numericRunId = Number(input.runId);
+  const runId = Number.isFinite(numericRunId) && numericRunId > 0 ? numericRunId : null;
+  const runUrl = typeof input.runUrl === "string" && input.runUrl.trim() ? input.runUrl.trim() : null;
+  const conclusion = typeof input.conclusion === "string" && input.conclusion.trim() ? input.conclusion.trim() : null;
+  const failedJobName = typeof input.failedJobName === "string" && input.failedJobName.trim() ? input.failedJobName.trim() : null;
+  const lastActiveStep = typeof input.lastActiveStep === "string" && input.lastActiveStep.trim() ? input.lastActiveStep.trim() : null;
+  const blockerCode = typeof input.blockerCode === "string" && input.blockerCode.trim() ? input.blockerCode.trim() : conclusion === "cancelled" ? "github_workflow_cancelled" : conclusion === "timed_out" ? "github_workflow_timed_out" : "github_workflow_failed";
+  const detail = failedJobName ? ` Failed job: ${failedJobName}.` : lastActiveStep ? ` Last active step: ${lastActiveStep}.` : "";
+  const summary = typeof input.message === "string" && input.message.trim() ? input.message.trim() : `${workflow ?? "GitHub workflow"} ${conclusion ? `completed with conclusion ${conclusion}` : "failed"}.${detail}`;
+  return {
+    summary,
+    provider: "github",
+    repository,
+    workflow,
+    runId,
+    runUrl,
+    inspectCommand: workflowInspectCommand(repository, runId),
+    failedJobName,
+    lastActiveStep,
+    conclusion,
+    retrySafe: input.retrySafe ?? true,
+    resumeSafe: input.resumeSafe ?? false,
+    blockerCode
+  };
+}
+async function dispatchGitHubWorkflowRun(repository, {
+  client = createGitHubApiClient(),
+  workflow = "deploy-web.yml",
+  branch,
+  inputs
+}) {
+  const { owner, name } = typeof repository === "string" ? parseGitHubRepositorySlug(repository) : repository;
+  try {
+    const result = await client.rest.actions.createWorkflowDispatch({
+      owner,
+      repo: name,
+      workflow_id: workflow,
+      ref: branch,
+      inputs
+    });
+    return {
+      repository: `${owner}/${name}`,
+      workflow,
+      branch,
+      inputs,
+      status: typeof result.status === "number" ? result.status : null,
+      dispatchedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+  } catch (error) {
+    throw normalizeGitHubApiError(error, `Unable to dispatch GitHub workflow ${workflow} in ${owner}/${name}`);
+  }
+}
+async function cancelGitHubWorkflowRun(repository, runId, { client = createGitHubApiClient() } = {}) {
+  if (!repository || !runId) {
+    return {
+      ok: false,
+      supported: false,
+      repository: typeof repository === "string" ? repository : null,
+      runId: null,
+      message: "GitHub workflow cancellation requires a repository and run id."
+    };
+  }
+  const { owner, name } = typeof repository === "string" ? parseGitHubRepositorySlug(repository) : repository;
+  const numericRunId = Number(runId);
+  if (!Number.isFinite(numericRunId) || numericRunId <= 0) {
+    return {
+      ok: false,
+      supported: false,
+      repository: `${owner}/${name}`,
+      runId: null,
+      message: "GitHub workflow cancellation requires a numeric run id."
+    };
+  }
+  try {
+    await client.rest.actions.cancelWorkflowRun({
+      owner,
+      repo: name,
+      run_id: numericRunId
+    });
+    return {
+      ok: true,
+      supported: true,
+      repository: `${owner}/${name}`,
+      runId: numericRunId,
+      url: `https://github.com/${owner}/${name}/actions/runs/${numericRunId}`,
+      message: "GitHub workflow cancellation requested.",
+      cancelledAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error ?? "");
+    if (/not supported|not found|404/iu.test(message)) {
+      return {
+        ok: false,
+        supported: false,
+        repository: `${owner}/${name}`,
+        runId: numericRunId,
+        message: "GitHub workflow cancellation is not supported for this run."
+      };
+    }
+    throw normalizeGitHubApiError(error, `Unable to cancel GitHub workflow run ${numericRunId} in ${owner}/${name}`);
+  }
+}
+async function getGitHubWorkflowFileStatus(repository, workflow = "deploy-web.yml", { client = createGitHubApiClient() } = {}) {
+  const { owner, name } = typeof repository === "string" ? parseGitHubRepositorySlug(repository) : repository;
+  const normalizedWorkflow = workflow.replace(/^\.github\/workflows\//u, "");
+  const path = `.github/workflows/${normalizedWorkflow}`;
+  try {
+    const result = await client.rest.repos.getContent({
+      owner,
+      repo: name,
+      path
+    });
+    const data = result.data;
+    return {
+      ok: true,
+      exists: true,
+      repository: `${owner}/${name}`,
+      workflow: normalizedWorkflow,
+      url: typeof data.html_url === "string" ? data.html_url : `https://github.com/${owner}/${name}/blob/HEAD/${path}`,
+      message: `${normalizedWorkflow} is present.`
+    };
+  } catch (error) {
+    const status = typeof error?.status === "number" ? error.status : null;
+    if (status === 404) {
+      return {
+        ok: true,
+        exists: false,
+        repository: `${owner}/${name}`,
+        workflow: normalizedWorkflow,
+        url: null,
+        message: `${normalizedWorkflow} is missing from ${owner}/${name}.`
+      };
+    }
+    throw normalizeGitHubApiError(error, `Unable to inspect GitHub workflow file ${path} in ${owner}/${name}`);
+  }
+}
+async function getLatestGitHubWorkflowRun(repository, {
+  client = createGitHubApiClient(),
+  workflow = "deploy-web.yml",
+  branch
+} = {}) {
+  const { owner, name } = typeof repository === "string" ? parseGitHubRepositorySlug(repository) : repository;
+  try {
+    const listed = await client.rest.actions.listWorkflowRuns({
+      owner,
+      repo: name,
+      workflow_id: workflow,
+      ...branch ? { branch } : {},
+      per_page: 1
+    });
+    const run = listed.data.workflow_runs[0] ?? null;
+    return run ? normalizeWorkflowRun(run) : null;
+  } catch (error) {
+    throw normalizeGitHubApiError(error, `Unable to inspect latest GitHub workflow run ${workflow} in ${owner}/${name}`);
+  }
+}
 async function listWorkflowJobsForProgress(client, owner, repo, runId) {
   try {
     const jobs = await client.rest.actions.listJobsForWorkflowRun({
@@ -717,11 +879,16 @@ async function ensureGitHubBranchFromBase(repository, branch, {
   }
 }
 export {
+  cancelGitHubWorkflowRun,
   createGitHubApiClient,
+  dispatchGitHubWorkflowRun,
   ensureGitHubActionsEnvironment,
   ensureGitHubBranchFromBase,
   ensureGitHubRepository,
+  formatGitHubWorkflowFailure,
   getGitHubRepository,
+  getGitHubWorkflowFileStatus,
+  getLatestGitHubWorkflowRun,
   listGitHubEnvironmentSecretNames,
   listGitHubEnvironmentVariableNames,
   listGitHubRepositorySecretNames,

package/dist/operations/services/local-dev.js

@@ -2,10 +2,10 @@ import { spawn, spawnSync } from "node:child_process";
 import { resolve } from "node:path";
 import { runLocalD1Migrations as applyLocalD1Migrations } from "./d1-migration.js";
 import {
-  fixtureMigrationsRoot,
   fixtureRoot,
   fixtureWranglerConfig,
-  corePackageRoot
+  corePackageRoot,
+  sdkD1MigrationsRoot
 } from "./runtime-paths.js";
 import { resolveTreeseedToolCommand } from "../../managed-dependencies.js";
 function mergeEnv(extraEnv = {}) {
@@ -41,7 +41,7 @@ function runLocalD1Migration(persistTo) {
   applyLocalD1Migrations({
     cwd: fixtureRoot,
     wranglerConfig: fixtureWranglerConfig,
-    migrationsRoot: fixtureMigrationsRoot,
+    migrationsRoot: sdkD1MigrationsRoot,
     persistTo
   });
 }

package/dist/operations/services/mailpit-runtime.d.ts

@@ -3,7 +3,18 @@ export type TreeseedMailpitContainer = {
     image: string;
     ports: string;
 };
+type RunDocker = typeof runDocker;
+declare function runDocker(args: string[], options?: {}): import("child_process").SpawnSyncReturns<string>;
 export declare function dockerIsAvailable(): boolean;
-export declare function findRunningMailpitContainer(): any;
-export declare function stopKnownMailpitContainers(): boolean;
+export declare function findRunningMailpitContainer(options?: {
+    run?: RunDocker;
+}): {
+    name: string;
+    image: string;
+    ports: string;
+} | null;
+export declare function stopKnownMailpitContainers(options?: {
+    run?: RunDocker;
+}): boolean;
 export declare function streamKnownMailpitLogs(): void;
+export {};

package/dist/operations/services/mailpit-runtime.js

@@ -1,6 +1,6 @@
 import { spawnSync } from "node:child_process";
 const EXPECTED_PORTS = ["1025->1025/tcp", "8025->8025/tcp"];
-const KNOWN_MAILPIT_NAMES = ["treeseed_mailpit", "karyon_docs_mailpit"];
+const KNOWN_MAILPIT_NAMES = ["treeseed_mailpit", "docs_mailpit"];
 function runDocker(args, options = {}) {
   return spawnSync("docker", args, {
     encoding: "utf8",
@@ -23,24 +23,29 @@ function dockerIsAvailable() {
   const result = runDocker(["ps", "--format", "{{.Names}}	{{.Image}}	{{.Ports}}"]);
   return result.status === 0;
 }
-function findRunningMailpitContainer() {
-  const result = runDocker(["ps", "--format", "{{.Names}}	{{.Image}}	{{.Ports}}"]);
+function findKnownMailpitContainers({ all = false, run = runDocker } = {}) {
+  const args = [
+    "ps",
+    ...all ? ["-a"] : [],
+    "--format",
+    "{{.Names}}	{{.Image}}	{{.Ports}}"
+  ];
+  const result = run(args);
   if (result.status !== 0) {
-    return null;
+    return [];
   }
-  return parseDockerPsOutput(result.stdout).find(isCompatibleMailpitContainer) ?? null;
+  return parseDockerPsOutput(result.stdout).filter(isCompatibleMailpitContainer);
 }
-function stopKnownMailpitContainers() {
-  const container = findRunningMailpitContainer();
-  if (!container) {
+function findRunningMailpitContainer(options = {}) {
+  return findKnownMailpitContainers(options).at(0) ?? null;
+}
+function stopKnownMailpitContainers(options = {}) {
+  const run = options.run ?? runDocker;
+  const containers = findKnownMailpitContainers({ all: true, run });
+  if (containers.length === 0) {
     return true;
   }
-  const stopResult = runDocker(["stop", container.name]);
-  if (stopResult.status !== 0) {
-    return false;
-  }
-  const removeResult = runDocker(["rm", "-f", container.name]);
-  return removeResult.status === 0;
+  return containers.every((container) => run(["rm", "-f", container.name]).status === 0);
 }
 function streamKnownMailpitLogs() {
   const container = findRunningMailpitContainer();