@treeseed/sdk 0.10.28 → 0.12.4

package/dist/capacity-provider.js

@@ -2,6 +2,7 @@ import {
   TREESEED_REMOTE_CONTRACT_HEADER,
   TREESEED_REMOTE_CONTRACT_VERSION
 } from "./remote.js";
+import { parse as parseYaml } from "yaml";
 import {
   collectTreeseedConfigSeedValues,
   collectTreeseedEnvironmentContext,
@@ -11,12 +12,19 @@ import {
 const CAPACITY_PROVIDER_ENDPOINTS = {
   register: "/v1/provider/register",
   heartbeat: "/v1/provider/heartbeat",
+  checkIn: "/v1/provider/check-in",
+  sessions: "/v1/provider/sessions",
   portfolio: "/v1/provider/portfolio",
   workdays: "/v1/provider/workdays",
-  claimTask: "/v1/provider/tasks/claim",
-  taskEvents: (taskId) => `/v1/provider/tasks/${encodeURIComponent(taskId)}/events`,
-  completeTask: (taskId) => `/v1/provider/tasks/${encodeURIComponent(taskId)}/complete`,
-  failTask: (taskId) => `/v1/provider/tasks/${encodeURIComponent(taskId)}/fail`,
+  nextAssignment: "/v1/provider/assignments/next",
+  assignment: (assignmentId) => `/v1/provider/assignments/${encodeURIComponent(assignmentId)}`,
+  assignmentRenew: (assignmentId) => `/v1/provider/assignments/${encodeURIComponent(assignmentId)}/renew`,
+  assignmentReturn: (assignmentId) => `/v1/provider/assignments/${encodeURIComponent(assignmentId)}/return`,
+  assignmentComplete: (assignmentId) => `/v1/provider/assignments/${encodeURIComponent(assignmentId)}/complete`,
+  assignmentFail: (assignmentId) => `/v1/provider/assignments/${encodeURIComponent(assignmentId)}/fail`,
+  assignmentModeRuns: (assignmentId) => `/v1/provider/assignments/${encodeURIComponent(assignmentId)}/mode-runs`,
+  assignmentWorkflowOperationDispatch: (assignmentId, operationId) => `/v1/provider/assignments/${encodeURIComponent(assignmentId)}/workflow-operations/${encodeURIComponent(operationId)}/dispatch`,
+  assignmentExplanation: (assignmentId) => `/v1/provider/assignments/${encodeURIComponent(assignmentId)}/explanation`,
   usage: "/v1/provider/usage",
   reports: "/v1/provider/reports"
 };
@@ -24,20 +32,23 @@ const CAPACITY_PROVIDER_SCOPES = [
   "provider:register",
   "provider:heartbeat",
   "provider:portfolio:read",
-  "provider:tasks:claim",
-  "provider:tasks:update",
+  "provider:assignments:read",
+  "provider:assignments:write",
   "provider:usage:report",
   "provider:reports:write",
   "provider:capabilities:write"
 ];
 const CAPACITY_PROVIDER_ENV_KEYS = [
+  "TREESEED_MANAGEMENT_API_URL",
   "TREESEED_MARKET_URL",
   "TREESEED_MARKET_ID",
+  "TREESEED_MANAGER_ID",
+  "TREESEED_CAPACITY_PROVIDER_ID",
+  "TREESEED_CAPACITY_PROVIDER_TEAM_ID",
   "TREESEED_CAPACITY_PROVIDER_API_KEY",
   "TREESEED_PROVIDER_HOST_DATA_DIR",
+  "TREESEED_HOST_CODEX_AUTH_FILE",
   "TREESEED_PROVIDER_DATA_DIR",
-  "TREESEED_PROVIDER_API_PORT",
-  "TREESEED_PROVIDER_HOST_API_PORT",
   "TREESEED_PROVIDER_ENVIRONMENT",
   "TREESEED_PROVIDER_CAPABILITIES_FILE",
   "TREESEED_PROVIDER_BUDGET_FILE",
@@ -48,9 +59,25 @@ const CAPACITY_PROVIDER_ENV_KEYS = [
   "TREESEED_PROVIDER_STARTUP_MODE",
   "TREESEED_CODEX_AUTH_FILE",
   "TREESEED_CODEX_AUTH_JSON_B64",
-  "TREESEED_CODEX_AUTH_OVERWRITE"
+  "TREESEED_CODEX_AUTH_OVERWRITE",
+  "TREESEED_TREEDX_BASE_URL",
+  "TREESEED_TREEDX_URL",
+  "TREESEED_TREEDX_TOKEN",
+  "TREESEED_TREEDX_REPO_ID",
+  "TREESEED_TREEDX_REF",
+  "TREESEED_TREEDX_WORKSPACE_ID",
+  "TREESEED_TREEDX_JWT_ISSUER",
+  "TREESEED_TREEDX_JWT_AUDIENCE",
+  "TREESEED_TREEDX_JWT_HS256_SECRET",
+  "TREESEED_TREEDX_PROXY_ACTOR_ID",
+  "TREESEED_TREEDX_PROXY_TENANT_ID"
 ];
 const CAPACITY_PROVIDER_DEPLOYMENT_SERVICE_ROLES = ["api", "manager", "runner"];
+const DEFAULT_CAPACITY_PROVIDER_ROLE_IMAGES = {
+  api: "treeseed/agent-provider-api",
+  manager: "treeseed/agent-manager",
+  runner: "treeseed/agent-runner"
+};
 class CapacityProviderApiError extends Error {
   constructor(message, status, payload) {
     super(message);
@@ -158,6 +185,26 @@ function assertCapacityProviderPortfolioManifest(value) {
     requireString(project, "slug", `Capacity provider portfolio project ${index}`);
     requireString(project, "name", `Capacity provider portfolio project ${index}`);
     if (!isRecord(project.repository)) throw new Error(`Capacity provider portfolio project ${index} is missing repository.`);
+    if (project.repositoryTopology !== void 0) {
+      if (!isRecord(project.repositoryTopology)) {
+        throw new Error(`Capacity provider portfolio project ${index} repositoryTopology must be an object.`);
+      }
+      if (!isRecord(project.repositoryTopology.contentRepository)) {
+        throw new Error(`Capacity provider portfolio project ${index} repositoryTopology is missing contentRepository.`);
+      }
+      if (project.repositoryTopology.contentRepository.accessMode !== "treedx") {
+        throw new Error(`Capacity provider portfolio project ${index} contentRepository must use treedx access.`);
+      }
+      if (!isRecord(project.repositoryTopology.siteRepository)) {
+        throw new Error(`Capacity provider portfolio project ${index} repositoryTopology is missing siteRepository.`);
+      }
+      if (project.repositoryTopology.siteRepository.accessMode !== "filesystem") {
+        throw new Error(`Capacity provider portfolio project ${index} siteRepository must use filesystem access.`);
+      }
+      if (project.repositoryTopology.projectRepository !== void 0 && project.repositoryTopology.projectRepository !== null && (!isRecord(project.repositoryTopology.projectRepository) || project.repositoryTopology.projectRepository.accessMode !== "filesystem")) {
+        throw new Error(`Capacity provider portfolio project ${index} projectRepository must use filesystem access.`);
+      }
+    }
     if (!isRecord(project.agentSpecs)) throw new Error(`Capacity provider portfolio project ${index} is missing agentSpecs.`);
     if (!isRecord(project.workPolicy)) throw new Error(`Capacity provider portfolio project ${index} is missing workPolicy.`);
   }
@@ -166,13 +213,15 @@ function resolveCapacityProviderEnvironment(input) {
   const env = {
     TREESEED_MARKET_URL: normalizeBaseUrl(input.marketUrl),
     TREESEED_MARKET_ID: input.marketId.trim(),
+    TREESEED_MANAGER_ID: input.marketId.trim(),
     TREESEED_CAPACITY_PROVIDER_API_KEY: input.apiKey.trim(),
     TREESEED_PROVIDER_DATA_DIR: input.providerDataDir ?? "/data",
-    TREESEED_PROVIDER_API_PORT: stringValue(input.providerApiPort, "3100"),
     TREESEED_PROVIDER_ENVIRONMENT: input.providerEnvironment ?? "local"
   };
-  if (!env.TREESEED_MARKET_ID) throw new Error("Capacity provider Market ID is required.");
+  env.TREESEED_MANAGEMENT_API_URL = env.TREESEED_MARKET_URL || "https://api.treeseed.dev";
   if (!env.TREESEED_CAPACITY_PROVIDER_API_KEY) throw new Error("Capacity provider API key is required.");
+  if (input.providerId) env.TREESEED_CAPACITY_PROVIDER_ID = input.providerId;
+  if (input.teamId) env.TREESEED_CAPACITY_PROVIDER_TEAM_ID = input.teamId;
   if (input.providerHostDataDir) env.TREESEED_PROVIDER_HOST_DATA_DIR = input.providerHostDataDir;
   if (input.capabilitiesFile) env.TREESEED_PROVIDER_CAPABILITIES_FILE = input.capabilitiesFile;
   if (input.budgetFile) env.TREESEED_PROVIDER_BUDGET_FILE = input.budgetFile;
@@ -215,12 +264,14 @@ function resolveCapacityProviderLaunchEnvironment(input = {}) {
   const diagnostic = input.diagnostic === true || values.TREESEED_PROVIDER_STARTUP_MODE === "diagnostic";
   const resolved = {
     TREESEED_PROVIDER_DATA_DIR: "/data",
-    TREESEED_PROVIDER_API_PORT: "3100",
     TREESEED_PROVIDER_ENVIRONMENT: scope,
     ...values
   };
-  if (!resolved.TREESEED_PROVIDER_HOST_API_PORT) {
-    resolved.TREESEED_PROVIDER_HOST_API_PORT = resolved.TREESEED_PROVIDER_API_PORT;
+  if (!resolved.TREESEED_MARKET_ID && resolved.TREESEED_MANAGER_ID) {
+    resolved.TREESEED_MARKET_ID = resolved.TREESEED_MANAGER_ID;
+  }
+  if (!resolved.TREESEED_MANAGER_ID && resolved.TREESEED_MARKET_ID) {
+    resolved.TREESEED_MANAGER_ID = resolved.TREESEED_MARKET_ID;
   }
   if (!resolved.TREESEED_PROVIDER_HOST_DATA_DIR) {
     resolved.TREESEED_PROVIDER_HOST_DATA_DIR = ".treeseed/local-capacity-provider/data";
@@ -229,8 +280,6 @@ function resolveCapacityProviderLaunchEnvironment(input = {}) {
     resolved.TREESEED_PROVIDER_STARTUP_MODE = "diagnostic";
   }
   const required = [
-    "TREESEED_MARKET_URL",
-    "TREESEED_MARKET_ID",
     ...diagnostic ? [] : ["TREESEED_CAPACITY_PROVIDER_API_KEY"],
     "TREESEED_PROVIDER_HOST_DATA_DIR"
   ];
@@ -261,8 +310,12 @@ function persistCapacityProviderConnectionToTreeseedConfig(input) {
   }
   const entryById = new Map(registryEntries.map((entry) => [entry.id, entry]));
   const keys = [
+    "TREESEED_MANAGEMENT_API_URL",
     "TREESEED_MARKET_URL",
     "TREESEED_MARKET_ID",
+    "TREESEED_MANAGER_ID",
+    "TREESEED_CAPACITY_PROVIDER_ID",
+    "TREESEED_CAPACITY_PROVIDER_TEAM_ID",
     "TREESEED_CAPACITY_PROVIDER_API_KEY",
     "TREESEED_PROVIDER_HOST_DATA_DIR",
     "TREESEED_PROVIDER_ENVIRONMENT"
@@ -292,6 +345,63 @@ function redactCapacityProviderEnv(env) {
   }
   return redacted;
 }
+function manifestRecord(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function manifestRoleImage(role, manifest) {
+  const tag = manifest.runtime?.images?.tag ?? "latest";
+  const roleConfig = manifest.runtime?.images?.roles?.[role] ?? {};
+  const extension = manifest.extensions?.[role];
+  if (extension?.enabled && extension.image) {
+    return `${extension.image}:${extension.tag ?? tag}`;
+  }
+  return `${roleConfig.image ?? DEFAULT_CAPACITY_PROVIDER_ROLE_IMAGES[role]}:${roleConfig.tag ?? tag}`;
+}
+function assertSafeCapacityProviderManifest(value) {
+  for (const [role, extension] of Object.entries(value.extensions ?? {})) {
+    if (!extension) continue;
+    for (const [key, entryValue] of Object.entries(extension.buildArgs ?? {})) {
+      if (entryValue === void 0 || entryValue === null || entryValue === "") continue;
+      if (isCapacityProviderSecretEnvKey(key) || /(?:tscp_|tsp_|sk-|ghp_|gho_|github_pat_)/u.test(String(entryValue))) {
+        throw new Error(`Capacity provider ${role} extension build arg ${key} looks secret-like. Store secrets in Treeseed config or the host secret manager instead.`);
+      }
+    }
+  }
+}
+function parseCapacityProviderLaunchManifest(source) {
+  const parsed = typeof source === "string" ? parseYaml(source) : source;
+  const record = manifestRecord(parsed);
+  if (record.schemaVersion !== 1) {
+    throw new Error("Capacity provider launch manifest schemaVersion must be 1.");
+  }
+  const manifest = record;
+  assertSafeCapacityProviderManifest(manifest);
+  return manifest;
+}
+function resolveCapacityProviderLaunchPlan(manifest) {
+  assertSafeCapacityProviderManifest(manifest);
+  const roleImages = {
+    api: manifestRoleImage("api", manifest),
+    manager: manifestRoleImage("manager", manifest),
+    runner: manifestRoleImage("runner", manifest)
+  };
+  const composeEnv = {
+    ...manifest.provider?.dataDir ? { TREESEED_PROVIDER_HOST_DATA_DIR: manifest.provider.dataDir } : {},
+    ...manifest.provider?.environment ? { TREESEED_PROVIDER_ENVIRONMENT: manifest.provider.environment } : {},
+    ...manifest.provider?.market?.url ? { TREESEED_MARKET_URL: manifest.provider.market.url } : {},
+    ...manifest.provider?.market?.id ? { TREESEED_MANAGER_ID: manifest.provider.market.id, TREESEED_MARKET_ID: manifest.provider.market.id } : {},
+    ...manifest.runtime?.runners?.maxConcurrent ? { TREESEED_PROVIDER_MAX_CONCURRENT_RUNNERS: String(manifest.runtime.runners.maxConcurrent) } : {},
+    TREESEED_AGENT_API_IMAGE: roleImages.api,
+    TREESEED_AGENT_MANAGER_IMAGE: roleImages.manager,
+    TREESEED_AGENT_RUNNER_IMAGE: roleImages.runner
+  };
+  return {
+    manifest,
+    roleImages,
+    composeEnv,
+    redactedEnv: redactCapacityProviderEnv(composeEnv)
+  };
+}
 function renderCapacityProviderSelfHostInstructions(input) {
   const env = resolveCapacityProviderEnvironment(input);
   return {
@@ -318,7 +428,7 @@ function defaultProviderDeploymentAdapter(hostKind) {
         role: spec.role,
         serviceName: spec.serviceName,
         serviceId: `${hostKind}:${spec.serviceName}`,
-        url: spec.role === "api" ? `https://${spec.serviceName}.example.invalid` : null,
+        url: null,
         status: "deployed",
         envRefs: Object.fromEntries(
           Object.keys(spec.env).map((key) => [key, isCapacityProviderSecretEnvKey(key) ? `${spec.serviceName}:${key}` : spec.redactedEnv[key] ?? spec.env[key]])
@@ -328,7 +438,11 @@ function defaultProviderDeploymentAdapter(hostKind) {
   };
 }
 async function deployCapacityProviderWithAdapter(input, launchMode, hostKind) {
-  const imageRef = input.imageRef ?? input.intent.imageRef ?? "ghcr.io/treeseed-ai/agent:capacity-provider";
+  const roleImageRefs = {
+    api: input.roleImageRefs?.api ?? input.imageRef ?? input.intent.imageRef ?? "treeseed/agent-provider-api:latest",
+    manager: input.roleImageRefs?.manager ?? input.imageRef ?? input.intent.imageRef ?? "treeseed/agent-manager:latest",
+    runner: input.roleImageRefs?.runner ?? input.imageRef ?? input.intent.imageRef ?? "treeseed/agent-runner:latest"
+  };
   const serviceNamePrefix = input.serviceNamePrefix ?? `${input.intent.capacityProviderId || "capacity-provider"}`.replace(/^cp[_-]?/u, "capacity-provider-").replace(/[^a-zA-Z0-9_.-]+/gu, "-");
   const env = { ...input.env };
   const redactedEnv = input.redactedEnv ?? redactCapacityProviderEnv(env);
@@ -340,7 +454,7 @@ async function deployCapacityProviderWithAdapter(input, launchMode, hostKind) {
       const result = await adapter.provisionService({
         role,
         serviceName: providerDeploymentServiceName(serviceNamePrefix, role),
-        imageRef,
+        imageRef: roleImageRefs[role],
         startCommand: providerDeploymentStartCommand(role),
         env,
         redactedEnv
@@ -359,7 +473,7 @@ async function deployCapacityProviderWithAdapter(input, launchMode, hostKind) {
       ok: true,
       launchMode,
       hostKind,
-      imageRef,
+      roleImageRefs,
       status: "deployed",
       serviceRefs: services,
       envRefs: Object.fromEntries(Object.keys(env).map((key) => [key, isCapacityProviderSecretEnvKey(key) ? "<host-secret>" : redactedEnv[key] ?? env[key]])),
@@ -372,7 +486,7 @@ async function deployCapacityProviderWithAdapter(input, launchMode, hostKind) {
       ok: false,
       launchMode,
       hostKind,
-      imageRef,
+      roleImageRefs,
       status: "failed",
       serviceRefs: services,
       envRefs: Object.fromEntries(Object.keys(env).map((key) => [key, isCapacityProviderSecretEnvKey(key) ? "<host-secret>" : redactedEnv[key] ?? env[key]])),
@@ -394,14 +508,15 @@ class MarketProviderClient {
   apiKey;
   fetchImpl;
   userAgent;
+  requestTimeoutMs;
   constructor(options) {
     this.marketUrl = normalizeBaseUrl(options.marketUrl);
     this.marketId = options.marketId.trim();
     this.apiKey = options.apiKey.trim();
-    if (!this.marketId) throw new Error("Capacity provider Market ID is required.");
     if (!this.apiKey) throw new Error("Capacity provider API key is required.");
     this.fetchImpl = options.fetchImpl ?? fetch;
     this.userAgent = options.userAgent;
+    this.requestTimeoutMs = Math.max(1e3, Number(options.requestTimeoutMs ?? 3e4) || 3e4);
   }
   async requestJson(path, options = {}) {
     const headers = {
@@ -411,11 +526,22 @@ class MarketProviderClient {
     };
     if (this.userAgent) headers["user-agent"] = this.userAgent;
     if (options.body !== void 0) headers["content-type"] = "application/json";
-    const response = await this.fetchImpl(`${this.marketUrl}${path}`, {
-      method: options.method ?? "GET",
-      headers,
-      body: options.body === void 0 ? void 0 : JSON.stringify(options.body)
-    });
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), this.requestTimeoutMs);
+    let response;
+    try {
+      response = await this.fetchImpl(`${this.marketUrl}${path}`, {
+        method: options.method ?? "GET",
+        headers,
+        body: options.body === void 0 ? void 0 : JSON.stringify(options.body),
+        signal: controller.signal
+      });
+    } catch (error) {
+      const message = error instanceof Error && error.name === "AbortError" ? `Capacity provider request timed out after ${this.requestTimeoutMs}ms: ${path}` : error instanceof Error ? error.message : String(error);
+      throw new CapacityProviderApiError(message, 0, { path, timeoutMs: this.requestTimeoutMs });
+    } finally {
+      clearTimeout(timeout);
+    }
     const payload = await response.json().catch(() => ({}));
     if (!response.ok) {
       const message = isRecord(payload) && typeof payload.error === "string" ? payload.error : `Capacity provider request failed with ${response.status}.`;
@@ -424,23 +550,48 @@ class MarketProviderClient {
     return payload;
   }
   register(request) {
+    const marketId = request.marketId ?? this.marketId;
+    const body = marketId ? { ...request, marketId } : request;
     return this.requestJson(CAPACITY_PROVIDER_ENDPOINTS.register, {
       method: "POST",
-      body: { ...request, marketId: request.marketId ?? this.marketId }
+      body
     }).then((response) => {
       assertCapacityProviderRegistrationResponse(response);
+      if (typeof response.sessionToken === "string" && response.sessionToken.trim()) {
+        this.apiKey = response.sessionToken.trim();
+      }
       return response;
     });
   }
   heartbeat(request = {}) {
+    const marketId = request.marketId ?? this.marketId;
+    const body = marketId ? { ...request, marketId } : request;
     return this.requestJson(CAPACITY_PROVIDER_ENDPOINTS.heartbeat, {
       method: "POST",
-      body: { ...request, marketId: request.marketId ?? this.marketId }
+      body
     }).then((response) => {
       assertCapacityProviderOkEnvelope(response, "Capacity provider heartbeat response");
       return response;
     });
   }
+  createAvailabilitySession(request = {}) {
+    return this.requestJson(CAPACITY_PROVIDER_ENDPOINTS.sessions, {
+      method: "POST",
+      body: request
+    }).then((response) => {
+      assertCapacityProviderOkEnvelope(response, "Capacity provider availability session response");
+      return response;
+    });
+  }
+  checkIn(request = {}) {
+    return this.requestJson(CAPACITY_PROVIDER_ENDPOINTS.checkIn, {
+      method: "POST",
+      body: request
+    }).then((response) => {
+      assertCapacityProviderOkEnvelope(response, "Capacity provider check-in response");
+      return response;
+    });
+  }
   portfolio() {
     return this.requestJson(CAPACITY_PROVIDER_ENDPOINTS.portfolio).then((response) => {
       assertCapacityProviderPortfolioManifest(response);
@@ -456,40 +607,78 @@ class MarketProviderClient {
       return response;
     });
   }
-  claimTask(request = {}) {
-    return this.requestJson(CAPACITY_PROVIDER_ENDPOINTS.claimTask, {
+  assignment(assignmentId) {
+    return this.requestJson(CAPACITY_PROVIDER_ENDPOINTS.assignment(assignmentId)).then((response) => {
+      assertCapacityProviderOkEnvelope(response, "Capacity provider assignment response");
+      return response;
+    });
+  }
+  assignmentExplanation(assignmentId) {
+    return this.requestJson(CAPACITY_PROVIDER_ENDPOINTS.assignmentExplanation(assignmentId)).then((response) => {
+      assertCapacityProviderOkEnvelope(response, "Capacity provider assignment explanation response");
+      return response;
+    });
+  }
+  nextAssignment(request = {}) {
+    return this.requestJson(CAPACITY_PROVIDER_ENDPOINTS.nextAssignment, {
+      method: "POST",
+      body: request
+    }).then((response) => {
+      assertCapacityProviderOkEnvelope(response, "Capacity provider next assignment response");
+      return response;
+    });
+  }
+  renewAssignment(assignmentId, request = {}) {
+    return this.requestJson(CAPACITY_PROVIDER_ENDPOINTS.assignmentRenew(assignmentId), {
+      method: "POST",
+      body: request
+    }).then((response) => {
+      assertCapacityProviderOkEnvelope(response, "Capacity provider assignment renew response");
+      return response;
+    });
+  }
+  returnAssignment(assignmentId, request = {}) {
+    return this.requestJson(CAPACITY_PROVIDER_ENDPOINTS.assignmentReturn(assignmentId), {
+      method: "POST",
+      body: request
+    }).then((response) => {
+      assertCapacityProviderOkEnvelope(response, "Capacity provider assignment return response");
+      return response;
+    });
+  }
+  completeAssignment(assignmentId, request = {}) {
+    return this.requestJson(CAPACITY_PROVIDER_ENDPOINTS.assignmentComplete(assignmentId), {
       method: "POST",
       body: request
     }).then((response) => {
-      assertCapacityProviderOkEnvelope(response, "Capacity provider task claim response");
-      if (!Array.isArray(response.tasks)) throw new Error("Capacity provider task claim response is missing tasks.");
+      assertCapacityProviderOkEnvelope(response, "Capacity provider assignment complete response");
       return response;
     });
   }
-  appendTaskEvent(taskId, request) {
-    return this.requestJson(CAPACITY_PROVIDER_ENDPOINTS.taskEvents(taskId), {
+  failAssignment(assignmentId, request = {}) {
+    return this.requestJson(CAPACITY_PROVIDER_ENDPOINTS.assignmentFail(assignmentId), {
       method: "POST",
       body: request
     }).then((response) => {
-      assertCapacityProviderOkEnvelope(response, "Capacity provider task event response");
+      assertCapacityProviderOkEnvelope(response, "Capacity provider assignment fail response");
       return response;
     });
   }
-  completeTask(taskId, request = {}) {
-    return this.requestJson(CAPACITY_PROVIDER_ENDPOINTS.completeTask(taskId), {
+  createAssignmentModeRun(assignmentId, request) {
+    return this.requestJson(CAPACITY_PROVIDER_ENDPOINTS.assignmentModeRuns(assignmentId), {
       method: "POST",
       body: request
     }).then((response) => {
-      assertCapacityProviderOkEnvelope(response, "Capacity provider task completion response");
+      assertCapacityProviderOkEnvelope(response, "Capacity provider mode run response");
       return response;
     });
   }
-  failTask(taskId, request) {
-    return this.requestJson(CAPACITY_PROVIDER_ENDPOINTS.failTask(taskId), {
+  dispatchAssignmentWorkflowOperation(assignmentId, operationId, request) {
+    return this.requestJson(CAPACITY_PROVIDER_ENDPOINTS.assignmentWorkflowOperationDispatch(assignmentId, operationId), {
       method: "POST",
       body: request
     }).then((response) => {
-      assertCapacityProviderOkEnvelope(response, "Capacity provider task failure response");
+      assertCapacityProviderOkEnvelope(response, "Capacity provider workflow operation dispatch response");
       return response;
     });
   }
@@ -518,6 +707,7 @@ export {
   CAPACITY_PROVIDER_ENV_KEYS,
   CAPACITY_PROVIDER_SCOPES,
   CapacityProviderApiError,
+  DEFAULT_CAPACITY_PROVIDER_ROLE_IMAGES,
   MarketProviderClient,
   assertCapacityProviderOkEnvelope,
   assertCapacityProviderPortfolioManifest,
@@ -526,10 +716,12 @@ export {
   deployCapacityProviderToManagedMarketHost,
   deployCapacityProviderToRailway,
   isCapacityProviderSecretEnvKey,
+  parseCapacityProviderLaunchManifest,
   persistCapacityProviderConnectionToTreeseedConfig,
   redactCapacityProviderEnv,
   redactCapacityProviderSecret,
   renderCapacityProviderSelfHostInstructions,
   resolveCapacityProviderEnvironment,
-  resolveCapacityProviderLaunchEnvironment
+  resolveCapacityProviderLaunchEnvironment,
+  resolveCapacityProviderLaunchPlan
 };

package/dist/capacity.d.ts

@@ -1,5 +1,5 @@
-import type { AttentionEstimate, AttentionPolicy, CapacityEstimateConfidence, CapacityGrant, CapacityPlan, CapacityProvider, CapacityProviderLane, CapacityReservation, CreditConversionProfile, CreateCapacityReservationRequest, CreateCapacityRoutingDecisionRequest, DerivedCapacityAvailability, DerivedCapacityInput, ExecutionProfile, HybridExecutionPlan, NativeUsageObservation, PlannedTaskNode, PlanningAdmissionResult, PlanningPolicy, PredictiveReservePolicy, ProjectEnvironmentName, RecordCapacityUsageRequest, ReservePrediction, TaskAdmissionDecision, TaskAdmissionPolicy, TaskClassification, TaskEstimateProfile, TaskPlanProposal, TaskMutationScope, TaskUsageActual, UtilityEstimate, UtilityPolicy, WorkdayBudgetEnvelope } from './sdk-types.ts';
-import type { AgentProviderProfile } from './types/agents.ts';
+import type { AttentionEstimate, AttentionPolicy, CapacityEstimateConfidence, CapacityGrant, CapacityPlan, CapacityProvider, CapacityProviderLane, CapacityReservation, CreditConversionProfile, CreateCapacityReservationRequest, CreateCapacityRoutingDecisionRequest, DerivedCapacityAvailability, DerivedCapacityInput, ExecutionProfile, HybridExecutionPlan, NativeUsageObservation, PlannedTaskNode, PlanningAdmissionResult, PlanningPolicy, PredictiveReservePolicy, ProjectEnvironmentName, RecordCapacityUsageRequest, ReservePrediction, TaskAdmissionDecision, TaskAdmissionPolicy, TaskClassification, TaskEstimateProfile, TaskPlanProposal, TaskMutationScope, TaskUsageActual, UtilityEstimate, UtilityPolicy, WorkdayBudgetEnvelope } from './sdk-types.js';
+import type { AgentProviderProfile } from './types/agents.js';
 export declare const ACTUAL_CREDIT_FORMULA_VERSION = "treeseed.actual-credits.v1";
 export interface ActualCreditCalculationInput {
     nativeUsage?: NativeUsageObservation | Record<string, unknown> | null;

package/dist/cli-tools.d.ts

@@ -1,3 +1,3 @@
-import type { AgentCliOptions } from './types/agents.ts';
+import type { AgentCliOptions } from './types/agents.js';
 export declare function normalizeAgentCliOptions(input: unknown): AgentCliOptions;
 export declare function buildCopilotAllowToolArgs(allowTools?: AgentCliOptions['allowTools']): string[];

package/dist/content-operations.d.ts

@@ -0,0 +1,97 @@
+import type { SdkModelRegistry } from './sdk-types.js';
+export type TreeseedContentAction = 'describe' | 'query' | 'read' | 'create' | 'update' | 'link' | 'validate' | 'commit';
+export type TreeseedContentModel = 'page' | 'note' | 'question' | 'proposal' | 'decision' | 'book' | 'knowledge' | 'objective' | 'person' | 'agent';
+export interface TreeseedContentRelationInput {
+    field: string;
+    targetModel?: TreeseedContentModel | string;
+    targetSlug: string;
+}
+export interface TreeseedContentPlacement {
+    bookSlug?: string;
+    parentPath?: string;
+    path?: string;
+}
+export interface TreeseedContentOperationInput {
+    action: TreeseedContentAction;
+    model?: TreeseedContentModel | string;
+    id?: string;
+    slug?: string;
+    title?: string;
+    fields?: Record<string, unknown>;
+    body?: string;
+    query?: string;
+    filters?: unknown[];
+    relations?: TreeseedContentRelationInput[];
+    placement?: TreeseedContentPlacement;
+    commit?: {
+        enabled: boolean;
+        message?: string;
+    };
+}
+export interface TreeseedContentRef {
+    model: TreeseedContentModel;
+    collection: string;
+    slug: string;
+    id?: string;
+    path?: string;
+    href?: string;
+}
+export interface TreeseedContentDiagnostic {
+    severity: 'info' | 'warning' | 'error';
+    code: string;
+    message: string;
+    field?: string;
+}
+export interface TreeseedContentOperationResult {
+    ok: true;
+    action: TreeseedContentAction;
+    refs: TreeseedContentRef[];
+    changedPaths?: string[];
+    diagnostics: TreeseedContentDiagnostic[];
+    payload?: Record<string, unknown>;
+}
+export interface RenderTreeseedContentInput {
+    model: TreeseedContentModel | string;
+    slug?: string;
+    title?: string;
+    fields?: Record<string, unknown>;
+    body?: string;
+    relations?: TreeseedContentRelationInput[];
+    placement?: TreeseedContentPlacement;
+    existingFrontmatter?: Record<string, unknown>;
+    registry?: SdkModelRegistry;
+    now?: string;
+}
+export interface RenderedTreeseedContentRecord {
+    model: TreeseedContentModel;
+    collection: string;
+    slug: string;
+    path: string;
+    frontmatter: Record<string, unknown>;
+    body: string;
+    content: string;
+    ref: TreeseedContentRef;
+    diagnostics: TreeseedContentDiagnostic[];
+}
+export interface TreeseedContentToolPreset {
+    id: string;
+    action: TreeseedContentAction;
+    model?: TreeseedContentModel;
+    title: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+export declare const TREESEED_CONTENT_ACTIONS: TreeseedContentAction[];
+export declare const TREESEED_CONTENT_READ_ACTIONS: Set<TreeseedContentAction>;
+export declare const TREESEED_CONTENT_WRITE_ACTIONS: Set<TreeseedContentAction>;
+export declare function slugifyTreeseedContent(value: unknown): string;
+export declare function renderTreeseedContentRecord(input: RenderTreeseedContentInput): RenderedTreeseedContentRecord;
+export declare function validateTreeseedContentRecord(model: string, source: string, registry?: SdkModelRegistry): {
+    ok: boolean;
+    frontmatter: Record<string, unknown>;
+    body: string;
+    diagnostics: TreeseedContentDiagnostic[];
+};
+export declare function genericTreeseedContentInputSchema(action: TreeseedContentAction): Record<string, unknown>;
+export declare function createTreeseedContentToolPresets(registry?: SdkModelRegistry): TreeseedContentToolPreset[];
+export declare function findTreeseedContentToolPreset(id: string, registry?: SdkModelRegistry): TreeseedContentToolPreset | null;