@treeseed/sdk 0.8.3 → 0.8.4

package/dist/platform/environment.js

@@ -26,15 +26,28 @@ const TREESEED_ENVIRONMENT_STORAGE = ["scoped", "shared"];
 const TREESEED_CONFIG_STARTUP_PROFILES = ["core", "optional", "advanced"];
 const TREESEED_ENVIRONMENT_VISIBILITY = ["user", "system"];
 const moduleDir = dirname(fileURLToPath(import.meta.url));
-function resolveCoreEnvironmentPath() {
+function firstExistingPath(candidates) {
+  return candidates.find((candidate) => existsSync(candidate)) ?? candidates[0];
+}
+function resolveSdkEnvironmentPath() {
   const candidates = [
     resolve(moduleDir, "env.yaml"),
     resolve(moduleDir, "../src/platform/env.yaml"),
     resolve(moduleDir, "../dist/platform/env.yaml")
   ];
-  return candidates.find((candidate) => existsSync(candidate)) ?? candidates[0];
-}
-const CORE_ENVIRONMENT_PATH = resolveCoreEnvironmentPath();
+  return firstExistingPath(candidates);
+}
+function resolveSiblingPackageEnvironmentPath(packageDir) {
+  return firstExistingPath([
+    resolve(moduleDir, `../../../${packageDir}/src/env.yaml`),
+    resolve(moduleDir, `../../../${packageDir}/dist/env.yaml`),
+    resolve(moduleDir, `../../${packageDir}/src/env.yaml`),
+    resolve(moduleDir, `../../${packageDir}/dist/env.yaml`)
+  ]);
+}
+const SDK_ENVIRONMENT_PATH = resolveSdkEnvironmentPath();
+const CORE_ENVIRONMENT_PATH = resolveSiblingPackageEnvironmentPath("core");
+const AGENT_ENVIRONMENT_PATH = resolveSiblingPackageEnvironmentPath("agent");
 const TENANT_ENVIRONMENT_OVERLAY_PATH = "src/env.yaml";
 const DEFAULT_TREESEED_MARKET_BASE_URL = "https://api.treeseed.ai";
 function loadOptionalTenantConfig() {
@@ -53,19 +66,53 @@ function smtpEnabled(context) {
 function platformSurfaceEnabled(context, surface) {
   return context.deployConfig.surfaces?.[surface]?.enabled !== false;
 }
+function activeWorkflowPlane() {
+  const plane = process.env.TREESEED_WORKFLOW_PLANE;
+  return plane === "web" || plane === "processing" ? plane : null;
+}
+function workflowPlaneAllows(plane) {
+  const activePlane = activeWorkflowPlane();
+  return activePlane === null || activePlane === plane;
+}
 function managedServiceEnabled(context, service) {
   return context.deployConfig.services?.[service]?.enabled !== false;
 }
 function webSurfaceEnabled(context) {
+  if (!workflowPlaneAllows("web")) {
+    return false;
+  }
   return platformSurfaceEnabled(context, "web");
 }
 function apiSurfaceEnabled(context) {
-  return platformSurfaceEnabled(context, "api") && managedServiceEnabled(context, "api");
+  if (!workflowPlaneAllows("processing")) {
+    return false;
+  }
+  const apiSurfaceExplicitlyEnabled = context.deployConfig.surfaces?.api?.enabled === true;
+  const apiServiceConfigured = context.deployConfig.services?.api != null && managedServiceEnabled(context, "api");
+  return (apiSurfaceExplicitlyEnabled || apiServiceConfigured) && managedServiceEnabled(context, "api");
+}
+function processingPlaneEnabled(context) {
+  if (!workflowPlaneAllows("processing")) {
+    return false;
+  }
+  const mode = context.deployConfig.processing?.mode ?? "market-assigned";
+  if (mode === "team-owned" || mode === "project-owned" || mode === "local") {
+    return true;
+  }
+  return Object.entries(context.deployConfig.services ?? {}).some(
+    ([service, config]) => ["api", "manager", "worker", "workerRunner", "workdayStart", "workdayReport"].includes(service) && config && config.enabled !== false
+  );
 }
 function formsEnabled(context) {
   return webSurfaceEnabled(context) && (context.deployConfig.providers?.forms ?? "store_only") !== "none";
 }
 function railwayManagedEnabled(context) {
+  if (!workflowPlaneAllows("processing")) {
+    return false;
+  }
+  if (!processingPlaneEnabled(context)) {
+    return false;
+  }
   if (context.deployConfig.runtime?.mode === "treeseed_managed") {
     return true;
   }
@@ -284,6 +331,7 @@ const PREDICATES = {
   smtpNonLocal: (context, scope) => smtpEnabled(context) && scope !== "local",
   webSurfaceEnabled: (context) => webSurfaceEnabled(context),
   apiSurfaceEnabled: (context) => apiSurfaceEnabled(context),
+  processingPlaneEnabled: (context) => processingPlaneEnabled(context),
   formsEnabled: (context) => formsEnabled(context),
   railwayManagedEnabled: (context) => railwayManagedEnabled(context),
   hubTreeseedHosted: (context) => resolveHubMode(context) === "treeseed_hosted",
@@ -395,11 +443,23 @@ function mergeEntryYaml(baseEntry, id, override) {
 }
 function collectOverlaySources(context) {
   const sources = [];
-  const coreOverlay = readYamlOverlayIfPresent(CORE_ENVIRONMENT_PATH);
-  if (!coreOverlay) {
-    throw new Error(`Treeseed core environment registry file was not found at ${CORE_ENVIRONMENT_PATH}.`);
+  const sdkOverlay = readYamlOverlayIfPresent(SDK_ENVIRONMENT_PATH);
+  if (!sdkOverlay) {
+    throw new Error(`Treeseed SDK environment registry file was not found at ${SDK_ENVIRONMENT_PATH}.`);
+  }
+  sources.push({ label: SDK_ENVIRONMENT_PATH, overlay: sdkOverlay });
+  if (webSurfaceEnabled(context)) {
+    const coreOverlay = readYamlOverlayIfPresent(CORE_ENVIRONMENT_PATH);
+    if (coreOverlay) {
+      sources.push({ label: CORE_ENVIRONMENT_PATH, overlay: coreOverlay });
+    }
+  }
+  if (apiSurfaceEnabled(context) || processingPlaneEnabled(context)) {
+    const agentOverlay = readYamlOverlayIfPresent(AGENT_ENVIRONMENT_PATH);
+    if (agentOverlay) {
+      sources.push({ label: AGENT_ENVIRONMENT_PATH, overlay: agentOverlay });
+    }
   }
-  sources.push({ label: CORE_ENVIRONMENT_PATH, overlay: coreOverlay });
   for (const pluginEntry of context.plugins) {
     const fileOverlay = readPluginEnvironmentOverlay(pluginEntry.baseDir);
     if (fileOverlay) {

package/dist/reconcile/builtin-adapters.js

@@ -1540,8 +1540,13 @@ function collectRailwayEnvironmentSync(input) {
   if (typeof values.CLOUDFLARE_ACCOUNT_ID === "string" && values.CLOUDFLARE_ACCOUNT_ID.length > 0) {
     variables.CLOUDFLARE_ACCOUNT_ID = values.CLOUDFLARE_ACCOUNT_ID;
   }
-  const apiD1DatabaseId = state.d1Databases?.SITE_DATA_DB?.databaseId;
-  if (typeof apiD1DatabaseId === "string" && apiD1DatabaseId.length > 0) {
+  const siteDataDb = state.d1Databases?.SITE_DATA_DB;
+  let apiD1DatabaseId = siteDataDb?.databaseId;
+  if (!hasLiveResourceId(apiD1DatabaseId)) {
+    const liveDatabase = findCloudflareD1ByName(input, buildCloudflareEnv(input), siteDataDb?.databaseName, { attempts: 3, delayMs: 250 });
+    apiD1DatabaseId = liveDatabase?.uuid ?? liveDatabase?.id ?? apiD1DatabaseId;
+  }
+  if (hasLiveResourceId(apiD1DatabaseId)) {
     variables.TREESEED_API_D1_DATABASE_ID = apiD1DatabaseId;
   }
   return { scope, secrets, variables };

package/dist/scripts/install-managed-dependencies.js

@@ -0,0 +1,12 @@
+import { formatTreeseedDependencyFailureDetails, installTreeseedDependencies } from '../managed-dependencies.js';
+const force = process.argv.includes('--force');
+const result = await installTreeseedDependencies({
+    tenantRoot: process.cwd(),
+    force,
+    env: process.env,
+});
+process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+if (!result.ok) {
+    process.stderr.write(`Treeseed dependency initialization failed:\n- ${formatTreeseedDependencyFailureDetails(result)}\n`);
+    process.exit(1);
+}

package/dist/scripts/tenant-workflow-action.js

@@ -4,12 +4,11 @@ import { resolveScope, runProjectPlatformAction, } from '../operations/services/
 const tenantRoot = process.cwd();
 function parseArgs(argv) {
     const parsed = {
-        action: 'deploy_code',
+        action: 'deploy_web',
         environment: null,
         projectId: null,
         previewId: null,
         dryRun: false,
-        skipProvision: false,
     };
     const rest = [...argv];
     while (rest.length) {
@@ -17,11 +16,11 @@ function parseArgs(argv) {
         if (!current)
             continue;
         if (current === '--action') {
-            parsed.action = (rest.shift() ?? parsed.action);
+            parsed.action = parseAction(rest.shift() ?? parsed.action);
             continue;
         }
         if (current.startsWith('--action=')) {
-            parsed.action = (current.split('=', 2)[1] ?? parsed.action);
+            parsed.action = parseAction(current.split('=', 2)[1] ?? parsed.action);
             continue;
         }
         if (current === '--environment') {
@@ -52,16 +51,20 @@ function parseArgs(argv) {
             parsed.dryRun = true;
             continue;
         }
-        if (current === '--skip-provision') {
-            parsed.skipProvision = true;
-            continue;
-        }
         throw new Error(`Unknown workflow action argument: ${current}`);
     }
     return parsed;
 }
+function parseAction(value) {
+    if (value === 'deploy_web' || value === 'deploy_processing' || value === 'publish_content' || value === 'monitor') {
+        return value;
+    }
+    throw new Error(`Unsupported workflow action "${value}". Expected deploy_web, deploy_processing, publish_content, or monitor.`);
+}
 async function main() {
     const options = parseArgs(process.argv.slice(2));
+    process.env.TREESEED_WORKFLOW_ACTION = options.action;
+    process.env.TREESEED_WORKFLOW_PLANE ||= options.action === 'deploy_processing' ? 'processing' : 'web';
     const scope = resolveScope(options.environment);
     const result = await runProjectPlatformAction(options.action, {
         tenantRoot,
@@ -69,7 +72,6 @@ async function main() {
         projectId: options.projectId ?? process.env.TREESEED_PROJECT_ID ?? null,
         previewId: options.previewId,
         dryRun: options.dryRun,
-        skipProvision: options.skipProvision,
     });
     if (result !== undefined) {
         process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);

package/dist/scripts/test-scaffold.js

@@ -171,7 +171,9 @@ function linkTreeseedBins(siteRoot) {
     mkdirSync(binRoot, { recursive: true });
     for (const [name, relativeTarget] of [
         ['treeseed', '../@treeseed/cli/dist/cli/main.js'],
-        ['treeseed-agents', '../@treeseed/core/dist/agents/cli.js'],
+        ['treeseed-agents', '../@treeseed/agent/dist/agents/cli.js'],
+        ['treeseed-agent-api', '../@treeseed/agent/dist/scripts/treeseed-agent-api.js'],
+        ['treeseed-agent-service', '../@treeseed/agent/dist/scripts/treeseed-agent-service.js'],
     ]) {
         symlinkSync(relativeTarget, resolve(binRoot, name));
     }

package/dist/scripts/workflow-commands.test.js

@@ -6,7 +6,7 @@ import {
 	deployTargetLabel,
 	loadDeployState,
 } from '../dist/scripts/deploy-lib.js';
-import { renderDeployWorkflow } from '../dist/scripts/github-automation-lib.js';
+import { renderDeployProcessingWorkflow, renderDeployWebWorkflow } from '../dist/operations/services/github-automation.js';
 import { incrementVersion } from '../dist/scripts/workspace-save-lib.js';
 import { makeTenantRoot } from './cli-test-fixtures.js';
 
@@ -25,11 +25,15 @@ test('branch preview state derives branch-specific worker names', () => {
 	assert.equal(state.previewEnabled, true);
 });
 
-test('deploy workflow targets staging and main branches', () => {
-	const workflow = renderDeployWorkflow({ workingDirectory: '.' });
-	assert.match(workflow, /- staging/);
-	assert.match(workflow, /- main/);
-	assert.match(workflow, /--environment \$\{\{ github\.ref_name == 'main' && 'prod' \|\| 'staging' \}\}/);
+test('deploy workflows expose final web and processing actions', () => {
+	const webWorkflow = renderDeployWebWorkflow({ workingDirectory: '.' });
+	const processingWorkflow = renderDeployProcessingWorkflow({ workingDirectory: '.' });
+	assert.match(webWorkflow, /default: deploy_web/);
+	assert.match(webWorkflow, /- publish_content/);
+	assert.doesNotMatch(webWorkflow, /RAILWAY_API_TOKEN/);
+	assert.match(processingWorkflow, /default: deploy_processing/);
+	assert.match(processingWorkflow, /RAILWAY_API_TOKEN/);
+	assert.match(processingWorkflow, /TREESEED_CAPACITY_PROVIDER_ID/);
 });
 
 test('version bump utility supports major, minor, and patch', () => {

package/dist/scripts/workspace-command-e2e.js

@@ -359,7 +359,7 @@ function cloneLocalWorkspace() {
     run('git', ['config', 'user.email', 'e2e@treeseed.dev'], { cwd: cloneRoot });
     const workflow = ensureDeployWorkflow(workingRoot);
     if (workflow.changed) {
-        run('git', ['add', 'docs/.github/workflows/deploy.yml'], { cwd: cloneRoot });
+        run('git', ['add', 'docs/.github/workflows/deploy-web.yml'], { cwd: cloneRoot });
         run('git', ['commit', '-m', 'test: sync deploy workflow for no-op save guard'], { cwd: cloneRoot });
     }
     return {

package/dist/treeseed/template-catalog/templates/starter-basic/template/package.json

@@ -26,6 +26,7 @@
   },
   "dependencies": {
     "@treeseed/cli": "__CLI_VERSION__",
+    "@treeseed/agent": "__AGENT_VERSION__",
     "@treeseed/core": "__CORE_VERSION__",
     "@treeseed/sdk": "__SDK_VERSION__",
     "yaml": "^2.8.1"

package/dist/treeseed/template-catalog/templates/starter-basic/template/src/api/server.js

@@ -1,4 +1,4 @@
-import { createRailwayTreeseedApiServer } from '@treeseed/core/api';
+import { createRailwayTreeseedApiServer } from '@treeseed/agent/api';
 
 const server = await createRailwayTreeseedApiServer();
 console.log(`Treeseed project API listening on ${server.url}`);

package/dist/treeseed/template-catalog/templates/starter-basic/template/treeseed.site.yaml

@@ -45,8 +45,9 @@ services:
     publicBaseUrl: https://__SITE_SLUG__-api.up.railway.app
     railway:
       serviceName: __SITE_SLUG__-api
-      buildCommand: npm run build
-      startCommand: node ./src/api/server.js
+      buildCommand: npm run build:api
+      startCommand: npm run build:api && node ./src/api/server.js
+      healthcheckTimeoutSeconds: 120
     environments:
       local:
         baseUrl: http://127.0.0.1:3000
@@ -56,16 +57,16 @@ services:
     railway:
       serviceName: __SITE_SLUG__-workday-manager
       rootDir: .
-      buildCommand: npm run build
-      startCommand: node ./node_modules/@treeseed/core/dist/services/workday-manager.js
+      buildCommand: npm run build:api
+      startCommand: npm run build:api && node ./packages/agent/dist/services/workday-manager.js
       schedule: '0 9 * * 1-5'
   workerRunner:
     enabled: true
     provider: railway
     railway:
       rootDir: .
-      buildCommand: npm run build
-      startCommand: node ./node_modules/@treeseed/core/dist/services/worker.js
+      buildCommand: npm run build:api
+      startCommand: npm run build:api && node ./packages/agent/dist/services/worker.js
 plugins:
   - package: '@treeseed/core/plugin-default'
 providers:

package/dist/treeseed/template-catalog/templates/starter-basic/template.config.json

@@ -65,6 +65,12 @@
       "deriveFrom": "coreVersion",
       "required": true
     },
+    {
+      "name": "Agent version",
+      "token": "__AGENT_VERSION__",
+      "deriveFrom": "agentVersion",
+      "required": true
+    },
     {
       "name": "SDK version",
       "token": "__SDK_VERSION__",

package/dist/workflow/operations.d.ts

@@ -1,4 +1,5 @@
 import { type ReleaseCandidateReport } from '../operations/services/release-candidate.ts';
+import { type RepositorySaveReport } from '../operations/services/repository-save-orchestrator.ts';
 import { type DevTagBranchScope } from '../operations/services/package-reference-policy.ts';
 import { resolveTreeseedWorkflowState, type TreeseedWorkflowStatusOptions } from '../workflow-state.ts';
 import { type TreeseedWorkflowRunCommand, type TreeseedWorkflowRunJournal } from './runs.ts';
@@ -372,8 +373,8 @@ export declare function workflowSave(helpers: WorkflowOperationHelpers, input: T
     branchSync: {
         pushed: boolean;
     };
-    repos: import("../operations/services/repository-save-orchestrator.ts").RepositorySaveReport[];
-    rootRepo: import("../operations/services/repository-save-orchestrator.ts").RepositorySaveReport;
+    repos: RepositorySaveReport[];
+    rootRepo: RepositorySaveReport;
     waves: string[][];
     plannedVersions: Record<string, string>;
     partialFailure: null;
@@ -515,8 +516,8 @@ export declare function workflowClose(helpers: WorkflowOperationHelpers, input:
         branchSync: {
             pushed: boolean;
         };
-        repos: import("../operations/services/repository-save-orchestrator.ts").RepositorySaveReport[];
-        rootRepo: import("../operations/services/repository-save-orchestrator.ts").RepositorySaveReport;
+        repos: RepositorySaveReport[];
+        rootRepo: RepositorySaveReport;
         waves: string[][];
         plannedVersions: Record<string, string>;
         partialFailure: null;
@@ -699,8 +700,8 @@ export declare function workflowStage(helpers: WorkflowOperationHelpers, input:
         branchSync: {
             pushed: boolean;
         };
-        repos: import("../operations/services/repository-save-orchestrator.ts").RepositorySaveReport[];
-        rootRepo: import("../operations/services/repository-save-orchestrator.ts").RepositorySaveReport;
+        repos: RepositorySaveReport[];
+        rootRepo: RepositorySaveReport;
         waves: string[][];
         plannedVersions: Record<string, string>;
         partialFailure: null;
@@ -936,6 +937,22 @@ export declare function workflowRelease(helpers: WorkflowOperationHelpers, input
     repos: never[];
     rootRepo: WorkflowRepoReport;
     releaseCandidate: ReleaseCandidateReport | null;
+    stagingWorkflowGates: Record<string, unknown>[] | {
+        name: string;
+        repository: string | null;
+        workflow: string;
+        branch: string;
+        headSha: string;
+        status: string;
+        reason: string;
+        conclusion: null;
+        runId: null;
+        url: null;
+        createdAt: null;
+        updatedAt: null;
+        timeoutSeconds: number | null;
+        cached: boolean;
+    }[];
     releaseBackMerge: {
         status: string;
         merged: boolean;
@@ -962,7 +979,7 @@ export declare function workflowRelease(helpers: WorkflowOperationHelpers, input
     };
     workspaceLinks: import("../operations/services/workspace-dependency-mode.ts").WorkspaceDependencyModeReport;
     ciMode: "hosted" | "off";
-    workflowGates: Record<string, unknown>[] | {
+    workflowGates: (Record<string, unknown> | {
         name: string;
         repository: string | null;
         workflow: string;
@@ -977,7 +994,7 @@ export declare function workflowRelease(helpers: WorkflowOperationHelpers, input
         updatedAt: null;
         timeoutSeconds: number | null;
         cached: boolean;
-    }[];
+    })[];
     hostingAudit: import("../workflow-support.ts").TreeseedHostingAuditReport | null;
 } & {
     finalState?: WorkflowStatePayload;
@@ -1067,6 +1084,22 @@ export declare function workflowRelease(helpers: WorkflowOperationHelpers, input
     repos: WorkflowRepoReport[];
     rootRepo: WorkflowRepoReport;
     releaseCandidate: ReleaseCandidateReport | null;
+    stagingWorkflowGates: Record<string, unknown>[] | {
+        name: string;
+        repository: string | null;
+        workflow: string;
+        branch: string;
+        headSha: string;
+        status: string;
+        reason: string;
+        conclusion: null;
+        runId: null;
+        url: null;
+        createdAt: null;
+        updatedAt: null;
+        timeoutSeconds: number | null;
+        cached: boolean;
+    }[];
     releaseBackMerge: {
         status: string;
         merged: boolean;