@treeseed/sdk 0.3.4 → 0.4.0

package/README.md

@@ -41,7 +41,7 @@ Consumer contract:
 ## Quickstart
 
 ```ts
-import { AgentSdk } from '@treeseed/sdk';
+import { AgentSdk } from '@treeseed/sdk/sdk';
 
 const sdk = new AgentSdk({
   repoRoot: '/absolute/path/to/your-site',
@@ -51,7 +51,7 @@ const sdk = new AgentSdk({
 Use `AgentSdk.createLocal()` when you want a local Wrangler-backed D1 database:
 
 ```ts
-import { AgentSdk } from '@treeseed/sdk';
+import { AgentSdk } from '@treeseed/sdk/sdk';
 
 const sdk = AgentSdk.createLocal({
   repoRoot: '/absolute/path/to/your-site',
@@ -71,7 +71,7 @@ The preferred graph API for new integrations is:
 Example:
 
 ```ts
-import { AgentSdk } from '@treeseed/sdk';
+import { AgentSdk } from '@treeseed/sdk/sdk';
 
 const sdk = new AgentSdk();
 const parsed = await sdk.parseGraphDsl(

package/dist/index.d.ts

@@ -13,15 +13,9 @@ export { TRESEED_OPERATION_SPECS, findTreeseedOperation, listTreeseedOperationNa
 export { TreeseedOperationsSdk } from './operations/runtime.ts';
 export { TreeseedWorkflowSdk } from './workflow.ts';
 export { getTreeseedVerifyDriverStatus, runTreeseedVerifyDriver } from './verification.ts';
-export * from './platform/contracts.ts';
-export * from './platform/tenant-config.ts';
-export * from './platform/deploy-config.ts';
-export * from './platform/deploy-runtime.ts';
-export * from './platform/environment.ts';
-export * from './platform/plugins.ts';
 export type { SdkContentEntry, SdkCursorEntity, SdkFilterCondition, SdkFollowRequest, SdkGraphEdge, SdkGraphEdgeType, SdkGraphDslRelation, SdkGraphDslParseResult, SdkGraphModelConfig, SdkGraphNode, SdkGraphNodeType, SdkGraphPathExplanation, SdkGraphQueryStage, SdkGraphQueryView, SdkGraphQueryOptions, SdkGraphQueryRequest, SdkGraphQueryResult, SdkGraphRankingBuildInput, SdkGraphRankingDiagnostics, SdkGraphRankingIndex, SdkGraphRankingNodeResult, SdkGraphRankingProvider, SdkGraphRankingQueryRequest, SdkGraphRankingQueryResult, SdkGraphRankingSearchRequest, SdkGraphRefreshPayload, SdkGraphRefreshRequest, SdkGraphSearchOptions, SdkGraphSearchResult, SdkGraphSeed, SdkGraphSeedResolution, SdkGraphTraversalResult, SdkGraphWhereFilter, SdkContextPack, SdkContextPackRequest, SdkGetRequest, SdkJsonEnvelope, SdkLeaseEntity, SdkManagerContextPayload, SdkMessageEntity, SdkModelFieldBinding, SdkModelDefinition, SdkModelRegistry, SdkModelName, SdkMutationRequest, SdkOperation, SdkPickRequest, SdkPickResult, SdkQueueMessageEnvelope, SdkRunEntity, SdkSearchRequest, SdkTaskEntity, SdkTaskEventEntity, SdkTaskOutputEntity, SdkWorkDayEntity, SdkGraphRunEntity, SdkReportEntity, SdkSubscriptionEntity, SdkTemplateCatalogEntry, SdkTemplateCatalogPublisher, SdkTemplateCatalogResponse, SdkTemplateCatalogSource, SdkUpdateRequest, } from './sdk-types.ts';
 export type { TreeseedFieldAliasBinding, TreeseedFieldAliasRegistry, } from './field-aliases.ts';
-export type { TreeseedOperationContext, TreeseedOperationGroup, TreeseedOperationImplementation, TreeseedOperationId, TreeseedOperationMetadata, TreeseedOperationProvider, TreeseedOperationProviderId, TreeseedOperationRequest, TreeseedOperationResult, } from './operations-types.ts';
+export type * from './operations-types.ts';
 export type * from './workflow.ts';
 export type { AgentDatabase } from './d1-store.ts';
 export type { D1DatabaseLike, D1PreparedStatementLike } from './types/cloudflare.ts';

package/dist/index.js

@@ -47,12 +47,6 @@ import {
 import { TreeseedOperationsSdk } from "./operations/runtime.js";
 import { TreeseedWorkflowSdk } from "./workflow.js";
 import { getTreeseedVerifyDriverStatus, runTreeseedVerifyDriver } from "./verification.js";
-export * from "./platform/contracts.js";
-export * from "./platform/tenant-config.js";
-export * from "./platform/deploy-config.js";
-export * from "./platform/deploy-runtime.js";
-export * from "./platform/environment.js";
-export * from "./platform/plugins.js";
 export {
   AgentSdk,
   BUILTIN_MODEL_REGISTRY,

package/dist/operations/runtime.js

@@ -1,4 +1,4 @@
-import { loadTreeseedDeployConfig } from "../platform/deploy/config.js";
+import { loadTreeseedDeployConfig } from "../platform/deploy-config.js";
 import { createDefaultTreeseedOperationsProvider } from "./providers/default.js";
 import { withProcessCwd } from "../operations/services/runtime-tools.js";
 import {

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

@@ -115,7 +115,7 @@ export declare function resolveTreeseedTemplateCatalogCachePath(startRoot?: stri
 export declare function ensureTreeseedGitignoreEntries(tenantRoot: any): string;
 export declare function resolveTreeseedMachineEnvironmentValues(tenantRoot: any, scope: any): any;
 export declare function setTreeseedMachineEnvironmentValue(tenantRoot: any, scope: any, entry: any, value: any): any;
-export declare function collectTreeseedEnvironmentContext(tenantRoot: any): import("../../index.ts").TreeseedResolvedEnvironmentRegistry;
+export declare function collectTreeseedEnvironmentContext(tenantRoot: any): import("../../platform/environment.ts").TreeseedResolvedEnvironmentRegistry;
 export declare function collectTreeseedConfigSeedValues(tenantRoot: any, scope: any, env?: NodeJS.ProcessEnv): any;
 export declare function formatTreeseedConfigEnvironmentReport({ tenantRoot, scope, env, revealSecrets }: {
     tenantRoot: any;
@@ -133,18 +133,18 @@ export declare function validateTreeseedCommandEnvironment({ tenantRoot, scope,
     scope: any;
     purpose: any;
 }): {
-    registry: import("../../index.ts").TreeseedResolvedEnvironmentRegistry;
+    registry: import("../../platform/environment.ts").TreeseedResolvedEnvironmentRegistry;
     values: any;
-    validation: import("../../index.ts").TreeseedEnvironmentValidationResult;
+    validation: import("../../platform/environment.ts").TreeseedEnvironmentValidationResult;
 };
 export declare function assertTreeseedCommandEnvironment({ tenantRoot, scope, purpose }: {
     tenantRoot: any;
     scope: any;
     purpose: any;
 }): {
-    registry: import("../../index.ts").TreeseedResolvedEnvironmentRegistry;
+    registry: import("../../platform/environment.ts").TreeseedResolvedEnvironmentRegistry;
     values: any;
-    validation: import("../../index.ts").TreeseedEnvironmentValidationResult;
+    validation: import("../../platform/environment.ts").TreeseedEnvironmentValidationResult;
 };
 export declare function writeTreeseedLocalEnvironmentFiles(tenantRoot: any): {
     envLocalPath: string;

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

@@ -10,7 +10,7 @@ import {
   TREESEED_ENVIRONMENT_SCOPES,
   validateTreeseedEnvironmentValues
 } from "../../platform/environment.js";
-import { loadTreeseedManifest } from "../../platform/tenant/config.js";
+import { loadTreeseedManifest } from "../../platform/tenant-config.js";
 import {
   createPersistentDeployTarget,
   ensureGeneratedWranglerConfig,

package/dist/operations/services/deploy.js

@@ -3,7 +3,7 @@ import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node
 import { dirname, relative, resolve } from "node:path";
 import { spawnSync } from "node:child_process";
 import { createInterface } from "node:readline/promises";
-import { deriveCloudflareWorkerName } from "../../platform/deploy/config.js";
+import { deriveCloudflareWorkerName } from "../../platform/deploy-config.js";
 import { loadCliDeployConfig, resolveWranglerBin } from "./runtime-tools.js";
 const DEFAULT_COMPATIBILITY_DATE = "2026-04-05";
 const DEFAULT_COMPATIBILITY_FLAGS = ["nodejs_compat"];

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

@@ -17,3 +17,4 @@ export declare const templateCatalogRoot: string;
 export declare const localTemplateArtifactsRoot: string;
 export declare const cliPackageVersion: any;
 export declare const corePackageVersion: any;
+export declare const sdkPackageVersion: any;

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

@@ -1,7 +1,7 @@
 import { existsSync, readFileSync } from "node:fs";
 import { resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import { corePackageRoot, packageRoot, runtimeRoot } from "./runtime-tools.js";
+import { corePackageRoot, packageRoot, runtimeRoot, sdkPackageRoot } from "./runtime-tools.js";
 const pathsRuntimeRoot = resolve(fileURLToPath(new URL("..", import.meta.url)));
 const cliPackageRoot = packageRoot;
 const cliRuntimeRoot = runtimeRoot ?? pathsRuntimeRoot;
@@ -31,6 +31,7 @@ const templateCatalogRoot = resolve(cliRuntimeRoot, "template-catalog");
 const localTemplateArtifactsRoot = resolve(templateCatalogRoot, "templates");
 const cliPackageVersion = readPackageVersion(cliPackageRoot);
 const corePackageVersion = readPackageVersion(corePackageRoot);
+const sdkPackageVersion = readPackageVersion(sdkPackageRoot);
 export {
   cliPackageRoot,
   cliPackageVersion,
@@ -46,6 +47,7 @@ export {
   mailpitComposeFile,
   packageRoot,
   referenceAppsRoot,
+  sdkPackageVersion,
   servicesRoot,
   templateCatalogRoot,
   templatesRoot,

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

@@ -10,7 +10,7 @@ const packageRootFromSource = resolve(scriptRoot, "..", "..", "..");
 const treeseedRuntimeRoot = resolve(packageRootFromSource, "src", "treeseed");
 const TREESEED_DEFAULT_PLUGIN_REFERENCES = [
   {
-    package: "@treeseed/core/plugin-default",
+    package: "@treeseed/sdk/plugin-default",
     enabled: true
   }
 ];

package/dist/operations/services/template-registry.d.ts

@@ -1,4 +1,4 @@
-import { type SdkTemplateCatalogEntry } from '@treeseed/sdk';
+import { type SdkTemplateCatalogEntry } from '../../sdk-types.ts';
 export declare const TEMPLATE_CATEGORIES: readonly ["starter", "example", "fixture", "reference-app"];
 export type TemplateCategory = (typeof TEMPLATE_CATEGORIES)[number];
 export interface TemplateVariableDefinition {
@@ -77,12 +77,12 @@ export declare function serializeTemplateRegistryEntry(product: Pick<TemplatePro
     featured: boolean;
     category: import("../../sdk-types.ts").SdkTemplateCategory;
     tags: string[];
-    publisher: import("@treeseed/sdk").SdkTemplateCatalogPublisher;
+    publisher: import("../../sdk-types.ts").SdkTemplateCatalogPublisher;
     templateVersion: string;
     templateApiVersion: number;
     minCliVersion: string;
     minCoreVersion: string | undefined;
-    source: import("@treeseed/sdk").SdkTemplateCatalogSource;
+    source: import("../../sdk-types.ts").SdkTemplateCatalogSource;
 };
 export declare function exportTemplateCatalogYaml(options?: TemplateCatalogOptions): Promise<string>;
 export {};

package/dist/operations/services/template-registry.js

@@ -1,8 +1,6 @@
 import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
 import { basename, dirname, relative, resolve } from "node:path";
-import {
-  RemoteTemplateCatalogClient
-} from "@treeseed/sdk";
+import { RemoteTemplateCatalogClient } from "../../template-catalog.js";
 import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
 import {
   resolveTreeseedTemplateCatalogCachePath,
@@ -11,7 +9,8 @@ import {
 import {
   cliPackageVersion,
   corePackageVersion,
-  localTemplateArtifactsRoot
+  localTemplateArtifactsRoot,
+  sdkPackageVersion
 } from "./runtime-paths.js";
 const TEMPLATE_CATEGORIES = ["starter", "example", "fixture", "reference-app"];
 function loadJsonFile(filePath) {
@@ -189,6 +188,8 @@ function resolveVariableValue(variable, input) {
       return `^${cliPackageVersion}`;
     case "coreVersion":
       return `^${corePackageVersion}`;
+    case "sdkVersion":
+      return `^${sdkPackageVersion}`;
     default:
       return variable.default ?? "";
   }

package/dist/platform/books-data.d.ts

@@ -1 +1,29 @@
-export * from './utils/books-data.ts';
+import type { TreeseedBookDefinition, TreeseedTenantConfig } from './contracts.ts';
+interface DocsLibraryDownload {
+    downloadFileName: string;
+    downloadHref: string;
+    downloadTitle: string;
+}
+interface TenantBookRuntime {
+    BOOKS: TreeseedBookDefinition[];
+    BOOKS_LINK: {
+        label: string;
+        link: string;
+    };
+    TREESEED_LINKS: {
+        home: string;
+    };
+    TREESEED_LIBRARY_DOWNLOAD: DocsLibraryDownload;
+}
+export declare function buildTenantBookRuntime(tenantConfig: Pick<TreeseedTenantConfig, 'content'>, options?: {
+    projectRoot?: string;
+    docsHomePath?: string;
+    docsLibraryDownload?: DocsLibraryDownload;
+}): TenantBookRuntime;
+export declare const BOOKS: TreeseedBookDefinition[], BOOKS_LINK: {
+    label: string;
+    link: string;
+}, TREESEED_LINKS: {
+    home: string;
+}, TREESEED_LIBRARY_DOWNLOAD: DocsLibraryDownload;
+export {};

package/dist/platform/books-data.js

@@ -1 +1,82 @@
-export * from "./utils/books-data.js";
+import { readFileSync, readdirSync, statSync } from "node:fs";
+import path from "node:path";
+import { parse as parseYaml } from "yaml";
+import { getTenantContentRoot } from "./tenant-config.js";
+import { RUNTIME_PROJECT_ROOT, RUNTIME_TENANT } from "./tenant/runtime-config.js";
+function sortPaths(paths) {
+  return [...paths].sort((left, right) => left.localeCompare(right, void 0, { numeric: true, sensitivity: "base" }));
+}
+function collectMarkdownFiles(rootPath) {
+  const stats = statSync(rootPath);
+  if (stats.isFile()) {
+    return [rootPath];
+  }
+  return sortPaths(
+    readdirSync(rootPath, { withFileTypes: true }).flatMap((entry) => {
+      const fullPath = path.join(rootPath, entry.name);
+      if (entry.isDirectory()) {
+        return collectMarkdownFiles(fullPath);
+      }
+      if (entry.isFile() && (entry.name.endsWith(".md") || entry.name.endsWith(".mdx"))) {
+        return [fullPath];
+      }
+      return [];
+    })
+  );
+}
+function parseFrontmatter(filePath) {
+  const raw = readFileSync(filePath, "utf8");
+  const match = raw.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  if (!match) {
+    throw new Error(`Book content entry is missing frontmatter: ${filePath}`);
+  }
+  return parseYaml(match[1]);
+}
+function inferDocsLibraryDownload(book) {
+  const title = book?.title ? `${book.title} Library` : "Knowledge Library";
+  return {
+    downloadFileName: "treeseed-knowledge.md",
+    downloadHref: "/books/treeseed-knowledge.md",
+    downloadTitle: title
+  };
+}
+function buildTenantBookRuntime(tenantConfig, options = {}) {
+  const projectRoot = options.projectRoot ?? process.cwd();
+  const booksContentRoot = path.resolve(projectRoot, getTenantContentRoot(tenantConfig, "books"));
+  const books = collectMarkdownFiles(booksContentRoot).map((filePath) => {
+    const frontmatter = parseFrontmatter(filePath);
+    return {
+      ...frontmatter,
+      id: path.basename(filePath, path.extname(filePath))
+    };
+  }).sort((left, right) => left.order - right.order);
+  const docsHomePath = options.docsHomePath ?? "/knowledge/";
+  const docsLibraryDownload = options.docsLibraryDownload ?? inferDocsLibraryDownload(tenantConfig);
+  return {
+    BOOKS: books,
+    BOOKS_LINK: {
+      label: "Books",
+      link: docsHomePath
+    },
+    TREESEED_LINKS: {
+      home: docsHomePath
+    },
+    TREESEED_LIBRARY_DOWNLOAD: docsLibraryDownload
+  };
+}
+const runtime = buildTenantBookRuntime(RUNTIME_TENANT, {
+  projectRoot: RUNTIME_PROJECT_ROOT,
+  docsLibraryDownload: {
+    downloadFileName: "treeseed-knowledge.md",
+    downloadHref: "/books/treeseed-knowledge.md",
+    downloadTitle: "TreeSeed Knowledge Library"
+  }
+});
+const { BOOKS, BOOKS_LINK, TREESEED_LINKS, TREESEED_LIBRARY_DOWNLOAD } = runtime;
+export {
+  BOOKS,
+  BOOKS_LINK,
+  TREESEED_LIBRARY_DOWNLOAD,
+  TREESEED_LINKS,
+  buildTenantBookRuntime
+};

package/dist/platform/deploy-config.d.ts

@@ -1 +1,4 @@
-export * from './deploy/config.ts';
+import type { TreeseedDeployConfig } from './contracts.ts';
+export declare function resolveTreeseedDeployConfigPath(configPath?: string): string;
+export declare function deriveCloudflareWorkerName(config: TreeseedDeployConfig): string;
+export declare function loadTreeseedDeployConfig(configPath?: string): TreeseedDeployConfig;

package/dist/platform/deploy-config.js

@@ -1 +1,222 @@
-export * from "./deploy/config.js";
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { normalizeAliasedRecord } from "../field-aliases.js";
+import { resolveTreeseedTenantRoot } from "./tenant-config.js";
+import {
+  TREESEED_DEFAULT_PLUGIN_REFERENCES,
+  TREESEED_DEFAULT_PROVIDER_SELECTIONS
+} from "./plugins/constants.js";
+const deployConfigFieldAliases = {
+  siteUrl: { key: "siteUrl", aliases: ["site_url"] },
+  contactEmail: { key: "contactEmail", aliases: ["contact_email"] }
+};
+const cloudflareFieldAliases = {
+  accountId: { key: "accountId", aliases: ["account_id"] },
+  workerName: { key: "workerName", aliases: ["worker_name"] }
+};
+const CLOUDFLARE_ACCOUNT_ID_PLACEHOLDER = "replace-with-cloudflare-account-id";
+function expectString(value, label) {
+  if (typeof value !== "string" || !value.trim()) {
+    throw new Error(`Invalid deploy config: expected ${label} to be a non-empty string.`);
+  }
+  return value.trim();
+}
+function optionalString(value) {
+  if (typeof value !== "string" || !value.trim()) {
+    return void 0;
+  }
+  return value.trim();
+}
+function optionalCloudflareAccountId(value) {
+  const accountId = optionalString(value);
+  return accountId === CLOUDFLARE_ACCOUNT_ID_PLACEHOLDER ? void 0 : accountId;
+}
+function optionalBoolean(value, label) {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (typeof value !== "boolean") {
+    throw new Error(`Invalid deploy config: expected ${label} to be a boolean when provided.`);
+  }
+  return value;
+}
+function optionalRecord(value, label) {
+  if (value === void 0 || value === null) {
+    return void 0;
+  }
+  if (typeof value !== "object" || Array.isArray(value)) {
+    throw new Error(`Invalid deploy config: expected ${label} to be an object when provided.`);
+  }
+  return value;
+}
+function parsePluginReferences(value) {
+  if (value === void 0) {
+    return [...TREESEED_DEFAULT_PLUGIN_REFERENCES];
+  }
+  if (!Array.isArray(value)) {
+    throw new Error("Invalid deploy config: expected plugins to be an array.");
+  }
+  return value.map((entry, index) => {
+    const record = optionalRecord(entry, `plugins[${index}]`);
+    return {
+      package: expectString(record?.package, `plugins[${index}].package`),
+      enabled: record?.enabled === void 0 ? true : optionalBoolean(record.enabled, `plugins[${index}].enabled`),
+      config: record?.config === void 0 ? {} : optionalRecord(record.config, `plugins[${index}].config`)
+    };
+  });
+}
+function parseProviderSelections(value) {
+  const record = optionalRecord(value, "providers");
+  if (!record) {
+    return structuredClone(TREESEED_DEFAULT_PROVIDER_SELECTIONS);
+  }
+  const agentProviders = optionalRecord(record.agents, "providers.agents") ?? {};
+  const contentProviders = optionalRecord(record.content, "providers.content") ?? {};
+  return {
+    forms: expectString(record.forms ?? TREESEED_DEFAULT_PROVIDER_SELECTIONS.forms, "providers.forms"),
+    operations: expectString(record.operations ?? TREESEED_DEFAULT_PROVIDER_SELECTIONS.operations, "providers.operations"),
+    agents: {
+      execution: expectString(
+        agentProviders.execution ?? TREESEED_DEFAULT_PROVIDER_SELECTIONS.agents.execution,
+        "providers.agents.execution"
+      ),
+      mutation: expectString(
+        agentProviders.mutation ?? TREESEED_DEFAULT_PROVIDER_SELECTIONS.agents.mutation,
+        "providers.agents.mutation"
+      ),
+      repository: expectString(
+        agentProviders.repository ?? TREESEED_DEFAULT_PROVIDER_SELECTIONS.agents.repository,
+        "providers.agents.repository"
+      ),
+      verification: expectString(
+        agentProviders.verification ?? TREESEED_DEFAULT_PROVIDER_SELECTIONS.agents.verification,
+        "providers.agents.verification"
+      ),
+      notification: expectString(
+        agentProviders.notification ?? TREESEED_DEFAULT_PROVIDER_SELECTIONS.agents.notification,
+        "providers.agents.notification"
+      ),
+      research: expectString(
+        agentProviders.research ?? TREESEED_DEFAULT_PROVIDER_SELECTIONS.agents.research,
+        "providers.agents.research"
+      )
+    },
+    deploy: expectString(record.deploy ?? TREESEED_DEFAULT_PROVIDER_SELECTIONS.deploy, "providers.deploy"),
+    content: {
+      docs: expectString(
+        contentProviders.docs ?? TREESEED_DEFAULT_PROVIDER_SELECTIONS.content.docs,
+        "providers.content.docs"
+      )
+    },
+    site: expectString(record.site ?? TREESEED_DEFAULT_PROVIDER_SELECTIONS.site, "providers.site")
+  };
+}
+function parseServiceEnvironmentConfig(value, label) {
+  const record = optionalRecord(value, label) ?? {};
+  return {
+    baseUrl: optionalString(record.baseUrl),
+    domain: optionalString(record.domain),
+    railwayEnvironment: optionalString(record.railwayEnvironment)
+  };
+}
+function parseManagedServiceConfig(value, label) {
+  const record = optionalRecord(value, label);
+  if (!record) {
+    return void 0;
+  }
+  const railway = optionalRecord(record.railway, `${label}.railway`) ?? {};
+  const environments = optionalRecord(record.environments, `${label}.environments`) ?? {};
+  return {
+    enabled: record.enabled === void 0 ? void 0 : optionalBoolean(record.enabled, `${label}.enabled`),
+    provider: optionalString(record.provider),
+    rootDir: optionalString(record.rootDir),
+    publicBaseUrl: optionalString(record.publicBaseUrl),
+    railway: {
+      projectId: optionalString(railway.projectId),
+      projectName: optionalString(railway.projectName),
+      serviceId: optionalString(railway.serviceId),
+      serviceName: optionalString(railway.serviceName),
+      rootDir: optionalString(railway.rootDir),
+      buildCommand: optionalString(railway.buildCommand),
+      startCommand: optionalString(railway.startCommand)
+    },
+    environments: {
+      local: parseServiceEnvironmentConfig(environments.local, `${label}.environments.local`),
+      staging: parseServiceEnvironmentConfig(environments.staging, `${label}.environments.staging`),
+      prod: parseServiceEnvironmentConfig(environments.prod, `${label}.environments.prod`)
+    }
+  };
+}
+function parseManagedServicesConfig(value) {
+  const record = optionalRecord(value, "services");
+  if (!record) {
+    return void 0;
+  }
+  return {
+    api: parseManagedServiceConfig(record.api, "services.api"),
+    agents: parseManagedServiceConfig(record.agents, "services.agents")
+  };
+}
+function parseDeployConfig(raw) {
+  const parsed = normalizeAliasedRecord(
+    deployConfigFieldAliases,
+    parseYaml(raw) ?? {}
+  );
+  const cloudflare = normalizeAliasedRecord(
+    cloudflareFieldAliases,
+    optionalRecord(parsed.cloudflare, "cloudflare") ?? {}
+  );
+  const smtp = optionalRecord(parsed.smtp, "smtp") ?? {};
+  const turnstile = optionalRecord(parsed.turnstile, "turnstile") ?? {};
+  optionalBoolean(turnstile.enabled, "turnstile.enabled");
+  return {
+    name: expectString(parsed.name, "name"),
+    slug: expectString(parsed.slug, "slug"),
+    siteUrl: expectString(parsed.siteUrl, "siteUrl"),
+    contactEmail: expectString(parsed.contactEmail, "contactEmail"),
+    cloudflare: {
+      accountId: optionalCloudflareAccountId(cloudflare.accountId) ?? optionalCloudflareAccountId(process.env.CLOUDFLARE_ACCOUNT_ID) ?? CLOUDFLARE_ACCOUNT_ID_PLACEHOLDER,
+      workerName: optionalString(cloudflare.workerName)
+    },
+    plugins: parsePluginReferences(parsed.plugins),
+    providers: parseProviderSelections(parsed.providers),
+    services: parseManagedServicesConfig(parsed.services),
+    smtp: {
+      enabled: optionalBoolean(smtp.enabled, "smtp.enabled")
+    },
+    turnstile: {
+      enabled: true
+    }
+  };
+}
+function resolveTreeseedDeployConfigPath(configPath = "treeseed.site.yaml") {
+  const tenantRoot = resolveTreeseedTenantRoot();
+  const candidate = resolve(tenantRoot, configPath);
+  if (!existsSync(candidate)) {
+    throw new Error(`Unable to resolve Treeseed deploy config at "${candidate}".`);
+  }
+  return candidate;
+}
+function deriveCloudflareWorkerName(config) {
+  return config.cloudflare.workerName?.trim() || config.slug;
+}
+function loadTreeseedDeployConfig(configPath = "treeseed.site.yaml") {
+  const resolvedConfigPath = resolveTreeseedDeployConfigPath(configPath);
+  const tenantRoot = dirname(resolvedConfigPath);
+  const parsed = parseDeployConfig(readFileSync(resolvedConfigPath, "utf8"));
+  Object.defineProperty(parsed, "__tenantRoot", {
+    value: tenantRoot,
+    enumerable: false
+  });
+  Object.defineProperty(parsed, "__configPath", {
+    value: resolvedConfigPath,
+    enumerable: false
+  });
+  return parsed;
+}
+export {
+  deriveCloudflareWorkerName,
+  loadTreeseedDeployConfig,
+  resolveTreeseedDeployConfigPath
+};

package/dist/platform/deploy-runtime.js

@@ -1,4 +1,4 @@
-import { loadTreeseedDeployConfig } from "./deploy/config.js";
+import { loadTreeseedDeployConfig } from "./deploy-config.js";
 import { TREESEED_DEFAULT_PLUGIN_REFERENCES, TREESEED_DEFAULT_PROVIDER_SELECTIONS } from "./plugins/constants.js";
 let cachedDeployConfig = null;
 function defaultDeployConfig() {

package/dist/platform/environment.d.ts

@@ -1,5 +1,5 @@
 import type { TreeseedDeployConfig, TreeseedTenantConfig } from './contracts.ts';
-import { type LoadedTreeseedPluginEntry } from './plugins/runtime.ts';
+import { type LoadedTreeseedPluginEntry } from './plugins.ts';
 export declare const TREESEED_ENVIRONMENT_SCOPES: readonly ["local", "staging", "prod"];
 export declare const TREESEED_ENVIRONMENT_REQUIREMENTS: readonly ["required", "conditional", "optional"];
 export declare const TREESEED_ENVIRONMENT_TARGETS: readonly ["local-file", "wrangler-dev-vars", "github-secret", "github-variable", "cloudflare-secret", "cloudflare-var", "railway-secret", "config-file"];

package/dist/platform/environment.js

@@ -3,9 +3,9 @@ import { existsSync, readFileSync } from "node:fs";
 import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { parse as parseYaml } from "yaml";
-import { loadTreeseedDeployConfig } from "./deploy/config.js";
-import { loadTreeseedPlugins } from "./plugins/runtime.js";
-import { loadTreeseedManifest } from "./tenant/config.js";
+import { loadTreeseedDeployConfig } from "./deploy-config.js";
+import { loadTreeseedPlugins } from "./plugins.js";
+import { loadTreeseedManifest } from "./tenant-config.js";
 const TREESEED_ENVIRONMENT_SCOPES = ["local", "staging", "prod"];
 const TREESEED_ENVIRONMENT_REQUIREMENTS = ["required", "conditional", "optional"];
 const TREESEED_ENVIRONMENT_TARGETS = [

package/dist/platform/plugin.d.ts

@@ -1,2 +1,51 @@
-export { defineTreeseedPlugin } from './plugins/plugin.ts';
-export type * from './plugins/plugin.ts';
+import type { TreeseedDeployConfig, TreeseedTenantConfig } from './contracts.ts';
+import type { TreeseedEnvironmentRegistryOverlay } from './environment.ts';
+import type { SdkGraphRankingProvider } from '../sdk-types.ts';
+export type TreeseedSiteLayerDefinition = {
+    root: string;
+    kinds?: Array<'pages' | 'styles' | 'components'>;
+};
+export type TreeseedSiteRouteContribution = {
+    pattern: string;
+    entrypoint?: string;
+    resourcePath?: string;
+};
+export type TreeseedSiteExtensionContribution = {
+    routes?: TreeseedSiteRouteContribution[];
+    starlightComponents?: Record<string, string>;
+    customCss?: string[];
+    remarkPlugins?: unknown[];
+    rehypePlugins?: unknown[];
+    envSchema?: Record<string, unknown>;
+    vitePlugins?: unknown[];
+    integrations?: unknown[];
+    routeMiddleware?: unknown[];
+};
+export type TreeseedPluginSiteContext = {
+    projectRoot: string;
+    tenantConfig: TreeseedTenantConfig;
+    siteConfig?: unknown;
+    deployConfig?: TreeseedDeployConfig;
+    pluginConfig: Record<string, unknown>;
+};
+export type TreeseedPluginEnvironmentContext = {
+    projectRoot: string;
+    tenantConfig?: TreeseedTenantConfig;
+    deployConfig?: TreeseedDeployConfig;
+    pluginConfig: Record<string, unknown>;
+};
+export type TreeseedGraphRankingProviderContribution = SdkGraphRankingProvider | ((context: TreeseedPluginEnvironmentContext) => SdkGraphRankingProvider | undefined);
+export interface TreeseedPlugin {
+    id?: string;
+    provides?: Record<string, any> & {
+        operations?: string[];
+    };
+    operationProviders?: Record<string, unknown>;
+    siteProviders?: Record<string, TreeseedSiteExtensionContribution | ((context: TreeseedPluginSiteContext) => TreeseedSiteExtensionContribution)>;
+    siteHooks?: TreeseedSiteExtensionContribution | ((context: TreeseedPluginSiteContext) => TreeseedSiteExtensionContribution);
+    siteLayers?: TreeseedSiteLayerDefinition[] | ((context: TreeseedPluginSiteContext) => TreeseedSiteLayerDefinition[] | undefined);
+    environmentRegistry?: TreeseedEnvironmentRegistryOverlay | ((context: TreeseedPluginEnvironmentContext) => TreeseedEnvironmentRegistryOverlay | undefined);
+    graphRankingProviders?: Record<string, TreeseedGraphRankingProviderContribution>;
+    [key: string]: unknown;
+}
+export declare function defineTreeseedPlugin<T extends TreeseedPlugin>(plugin: T): T;

package/dist/platform/plugin.js

@@ -1,4 +1,6 @@
-import { defineTreeseedPlugin } from "./plugins/plugin.js";
+function defineTreeseedPlugin(plugin) {
+  return plugin;
+}
 export {
   defineTreeseedPlugin
 };

package/dist/platform/plugins/constants.d.ts

@@ -1,4 +1,4 @@
-export declare const TREESEED_DEFAULT_PLUGIN_PACKAGE = "@treeseed/core/plugin-default";
+export declare const TREESEED_DEFAULT_PLUGIN_PACKAGE = "@treeseed/sdk/plugin-default";
 export declare const TREESEED_DEFAULT_PROVIDER_SELECTIONS: {
     forms: string;
     operations: string;