@treeseed/sdk 0.10.23 → 0.10.25

package/dist/sdk-types.d.ts

@@ -21,6 +21,16 @@ export declare const PROJECT_DEPLOYMENT_STATUSES: readonly ["pending", "queued",
 export declare const PROJECT_INFRA_RESOURCE_PROVIDERS: readonly ["cloudflare", "railway", "github", "market"];
 export declare const PROJECT_INFRA_RESOURCE_KINDS: readonly ["pages", "worker", "kv", "turnstile-widget", "r2", "d1", "queue", "dlq", "railway_project", "railway_service", "railway_schedule"];
 export declare const AGENT_POOL_STATUSES: readonly ["pending", "active", "degraded", "offline"];
+export declare const TREESEED_DEFAULT_STARTER_TEMPLATE_ID: "starter-research";
+export declare const TEMPLATE_HOST_REQUIREMENT_TYPES: readonly ["repository", "web", "email", "ai"];
+export declare const TEMPLATE_RESOURCE_REQUIREMENT_TYPES: readonly ["service", "database", "object-storage", "queue", "dns-zone"];
+export declare const TEMPLATE_SECRET_SENSITIVITIES: readonly ["secret", "plain", "derived"];
+export declare const TEMPLATE_SECRET_TARGETS: readonly ["github-secret", "github-variable", "cloudflare-secret", "cloudflare-var", "railway-secret", "railway-var", "config-file", "local-runtime"];
+export declare const TEMPLATE_SECRET_SOURCES: readonly ["generated", "selected-host", "user-input", "derived"];
+export declare const TEMPLATE_CONFIG_WRITE_TARGETS: readonly ["treeseed.site.yaml", "src/env.yaml", "src/manifest.yaml", "package.json"];
+export declare const TEMPLATE_CONFIG_WRITE_WHEN: readonly ["always", "host-selected", "feature-enabled"];
+export declare const TEMPLATE_CONFIG_MERGE_STRATEGIES: readonly ["replace", "deep-merge", "append-unique"];
+export declare const PROJECT_LAUNCH_REQUIREMENT_KINDS: readonly ["host", "resource", "secret"];
 export type SdkBuiltinModelName = (typeof SDK_MODEL_NAMES)[number];
 export type SdkModelName = SdkBuiltinModelName | (string & {});
 export type SdkOperation = (typeof SDK_OPERATIONS)[number];
@@ -49,6 +59,82 @@ export type ProjectInfrastructureResourceProvider = (typeof PROJECT_INFRA_RESOUR
 export type ProjectInfrastructureResourceKind = (typeof PROJECT_INFRA_RESOURCE_KINDS)[number];
 export type AgentPoolStatus = (typeof AGENT_POOL_STATUSES)[number];
 export type RemoteJobRequestedByType = 'user' | 'team_api_key' | 'service' | 'runner' | 'system';
+export type TemplateHostRequirementType = (typeof TEMPLATE_HOST_REQUIREMENT_TYPES)[number];
+export type TemplateResourceRequirementType = (typeof TEMPLATE_RESOURCE_REQUIREMENT_TYPES)[number];
+export type TemplateSecretSensitivity = (typeof TEMPLATE_SECRET_SENSITIVITIES)[number];
+export type TemplateSecretTarget = (typeof TEMPLATE_SECRET_TARGETS)[number];
+export type TemplateSecretSource = (typeof TEMPLATE_SECRET_SOURCES)[number];
+export type TemplateConfigWriteTarget = (typeof TEMPLATE_CONFIG_WRITE_TARGETS)[number];
+export type TemplateConfigWriteWhen = (typeof TEMPLATE_CONFIG_WRITE_WHEN)[number];
+export type TemplateConfigMergeStrategy = (typeof TEMPLATE_CONFIG_MERGE_STRATEGIES)[number];
+export type ProjectLaunchRequirementKind = (typeof PROJECT_LAUNCH_REQUIREMENT_KINDS)[number];
+export interface TemplateConfigWrite {
+    target: TemplateConfigWriteTarget;
+    path: string;
+    valueFrom: string;
+    writeWhen?: TemplateConfigWriteWhen;
+    mergeStrategy?: TemplateConfigMergeStrategy;
+}
+export interface TemplateEnvironmentWrite {
+    env: string;
+    valueFrom: string;
+    targets?: TemplateSecretTarget[];
+    scopes?: ProjectEnvironmentName[];
+    sensitivity?: TemplateSecretSensitivity;
+}
+export interface TemplateHostRequirement {
+    kind: 'host';
+    key: string;
+    type: TemplateHostRequirementType;
+    required: boolean;
+    compatibleProviders?: string[];
+    displayName: string;
+    purpose: string;
+    defaultSelection?: 'team-default' | 'managed' | 'none';
+    configWrites: TemplateConfigWrite[];
+    environmentWrites?: TemplateEnvironmentWrite[];
+}
+export interface TemplateResourceRequirement {
+    kind: 'resource';
+    key: string;
+    type: TemplateResourceRequirementType;
+    required: boolean;
+    compatibleProviders?: string[];
+    displayName: string;
+    purpose: string;
+    configWrites: TemplateConfigWrite[];
+    environmentWrites?: TemplateEnvironmentWrite[];
+}
+export interface TemplateSecretRequirement {
+    kind: 'secret';
+    key: string;
+    env: string;
+    required: boolean;
+    sensitivity: TemplateSecretSensitivity;
+    targets: TemplateSecretTarget[];
+    source: TemplateSecretSource;
+}
+export interface TemplateLaunchRequirements {
+    version?: number;
+    hosts?: TemplateHostRequirement[];
+    resources?: TemplateResourceRequirement[];
+    secrets?: TemplateSecretRequirement[];
+}
+export interface ProjectLaunchHostBindingInput {
+    requirementKey: string;
+    requirementKind: ProjectLaunchRequirementKind;
+    type: string;
+    provider: string;
+    hostId?: string | null;
+    managedHostKey?: string | null;
+    mode?: string | null;
+    displayName?: string;
+    environmentScopes?: ProjectEnvironmentName[];
+    configValues?: Record<string, unknown>;
+    environmentValues?: Record<string, string>;
+    secretRefs?: Record<string, string>;
+    selectedBy?: 'user' | 'team-default' | 'managed-default' | 'template-default';
+}
 export declare function projectConnectionModeFromHosting(kind: TreeseedHostingKind, registration?: TreeseedHostingRegistration): ProjectConnectionMode;
 export interface SdkDispatchCapability {
     namespace: SdkDispatchNamespace;
@@ -2536,6 +2622,7 @@ export interface SdkTemplateCatalogEntry {
     relatedBooks?: string[];
     relatedKnowledge?: string[];
     relatedObjectives?: string[];
+    launchRequirements?: TemplateLaunchRequirements;
 }
 export interface SdkTemplateCatalogResponse {
     items: SdkTemplateCatalogEntry[];

package/dist/sdk-types.js

@@ -59,6 +59,25 @@ const PROJECT_INFRA_RESOURCE_KINDS = [
   "railway_schedule"
 ];
 const AGENT_POOL_STATUSES = ["pending", "active", "degraded", "offline"];
+const TREESEED_DEFAULT_STARTER_TEMPLATE_ID = "starter-research";
+const TEMPLATE_HOST_REQUIREMENT_TYPES = ["repository", "web", "email", "ai"];
+const TEMPLATE_RESOURCE_REQUIREMENT_TYPES = ["service", "database", "object-storage", "queue", "dns-zone"];
+const TEMPLATE_SECRET_SENSITIVITIES = ["secret", "plain", "derived"];
+const TEMPLATE_SECRET_TARGETS = [
+  "github-secret",
+  "github-variable",
+  "cloudflare-secret",
+  "cloudflare-var",
+  "railway-secret",
+  "railway-var",
+  "config-file",
+  "local-runtime"
+];
+const TEMPLATE_SECRET_SOURCES = ["generated", "selected-host", "user-input", "derived"];
+const TEMPLATE_CONFIG_WRITE_TARGETS = ["treeseed.site.yaml", "src/env.yaml", "src/manifest.yaml", "package.json"];
+const TEMPLATE_CONFIG_WRITE_WHEN = ["always", "host-selected", "feature-enabled"];
+const TEMPLATE_CONFIG_MERGE_STRATEGIES = ["replace", "deep-merge", "append-unique"];
+const PROJECT_LAUNCH_REQUIREMENT_KINDS = ["host", "resource", "secret"];
 function projectConnectionModeFromHosting(kind, registration = "none") {
   if (kind === "hosted_project") {
     return "hosted";
@@ -78,6 +97,7 @@ export {
   PROJECT_EXECUTION_OWNERS,
   PROJECT_INFRA_RESOURCE_KINDS,
   PROJECT_INFRA_RESOURCE_PROVIDERS,
+  PROJECT_LAUNCH_REQUIREMENT_KINDS,
   PROJECT_RUNNER_REGISTRATION_STATES,
   PROJECT_WEB_DEPLOYMENT_ACTIONS,
   REMOTE_JOB_STATUSES,
@@ -89,6 +109,15 @@ export {
   SDK_OPERATIONS,
   SDK_PICK_STRATEGIES,
   SDK_STORAGE_BACKENDS,
+  TEMPLATE_CONFIG_MERGE_STRATEGIES,
+  TEMPLATE_CONFIG_WRITE_TARGETS,
+  TEMPLATE_CONFIG_WRITE_WHEN,
+  TEMPLATE_HOST_REQUIREMENT_TYPES,
+  TEMPLATE_RESOURCE_REQUIREMENT_TYPES,
+  TEMPLATE_SECRET_SENSITIVITIES,
+  TEMPLATE_SECRET_SOURCES,
+  TEMPLATE_SECRET_TARGETS,
+  TREESEED_DEFAULT_STARTER_TEMPLATE_ID,
   TREESEED_HOSTING_KINDS,
   TREESEED_HOSTING_REGISTRATIONS,
   projectConnectionModeFromHosting

package/dist/template-catalog.js

@@ -1,5 +1,6 @@
 import { readFileSync } from "node:fs";
 import { resolve } from "node:path";
+import { normalizeTemplateLaunchRequirements } from "./template-launch-requirements.js";
 function expectRecord(value, label) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
     throw new Error(`Invalid template catalog response: expected ${label} to be an object.`);
@@ -91,7 +92,8 @@ function normalizeTemplateCatalogEntry(value) {
     } : void 0,
     relatedBooks: optionalStringArray(record.relatedBooks, "relatedBooks") ?? [],
     relatedKnowledge: optionalStringArray(record.relatedKnowledge, "relatedKnowledge") ?? [],
-    relatedObjectives: optionalStringArray(record.relatedObjectives, "relatedObjectives") ?? []
+    relatedObjectives: optionalStringArray(record.relatedObjectives, "relatedObjectives") ?? [],
+    launchRequirements: normalizeTemplateLaunchRequirements(record.launchRequirements, "launchRequirements")
   };
 }
 function parseTemplateCatalogResponse(payload) {

package/dist/template-launch-requirements.d.ts

@@ -0,0 +1,118 @@
+import { type ProjectEnvironmentName, type ProjectLaunchHostBindingInput, type ProjectLaunchRequirementKind, type TemplateConfigWrite, type TemplateLaunchRequirements } from './sdk-types.ts';
+type Mutable<T> = {
+    -readonly [P in keyof T]: T[P];
+};
+export type { TemplateLaunchRequirements } from './sdk-types.ts';
+export interface ProjectLaunchHostInventoryRecord {
+    id: string;
+    type?: string | null;
+    provider: string;
+    ownership?: string | null;
+    name?: string | null;
+    accountLabel?: string | null;
+    organizationOrOwner?: string | null;
+    allowedEnvironments?: ProjectEnvironmentName[];
+    status?: string | null;
+    metadata?: Record<string, unknown>;
+}
+export interface ProjectLaunchResolvedHostBinding {
+    requirementKey: string;
+    requirementKind: ProjectLaunchRequirementKind;
+    type: string;
+    provider: string;
+    hostId?: string | null;
+    managedHostKey?: string | null;
+    displayName: string;
+    environmentScopes: ProjectEnvironmentName[];
+    configValues: Record<string, unknown>;
+    environmentValues: Record<string, string>;
+    secretRefs: Record<string, string>;
+    provenance: {
+        selectedBy: NonNullable<ProjectLaunchHostBindingInput['selectedBy']>;
+        selectedAt: string;
+    };
+    host: {
+        id: string;
+        name: string | null;
+        ownership: string | null;
+        status: string | null;
+        accountLabel?: string | null;
+        organizationOrOwner?: string | null;
+        metadata?: Record<string, unknown>;
+    } | null;
+}
+export interface ProjectLaunchConfigWritePlanItem extends TemplateConfigWrite {
+    requirementKey: string;
+    requirementKind: ProjectLaunchRequirementKind;
+    requirementType: string;
+    provider: string;
+}
+export interface ProjectLaunchSecretDeploymentPlanItem {
+    requirementKey: string;
+    requirementKind: ProjectLaunchRequirementKind;
+    env: string;
+    sensitivity: string;
+    source: string;
+    targets: string[];
+    scopes: ProjectEnvironmentName[];
+    sourceHostId?: string | null;
+}
+export interface ResolveProjectLaunchHostBindingsOptions {
+    hostBindings?: Record<string, ProjectLaunchHostBindingInput>;
+    launchRequirements?: TemplateLaunchRequirements | null;
+    repositoryHosts?: ProjectLaunchHostInventoryRecord[];
+    teamHosts?: ProjectLaunchHostInventoryRecord[];
+    managedHosts?: ProjectLaunchHostInventoryRecord[];
+    defaultHosts?: Record<string, unknown> | null;
+    domains?: Record<string, unknown> | null;
+    projectSlug?: string | null;
+    projectName?: string | null;
+    standardProjectLaunch?: boolean;
+    selectedAt?: string;
+}
+export interface ResolveProjectLaunchHostBindingsResult {
+    hostBindings: Record<string, ProjectLaunchResolvedHostBinding>;
+    compatibility: {
+        repositoryHostId?: string | null;
+        cloudflareHostMode?: 'team_owned' | 'treeseed_managed' | null;
+        cloudflareHostId?: string | null;
+        emailHostMode?: 'team_owned' | 'treeseed_managed' | null;
+        emailHostId?: string | null;
+    };
+    configWritePlan: ProjectLaunchConfigWritePlanItem[];
+    secretDeploymentPlan: {
+        items: ProjectLaunchSecretDeploymentPlanItem[];
+    };
+    diagnostics: Array<{
+        code: string;
+        message: string;
+        requirementKey?: string;
+    }>;
+}
+export interface ProjectLaunchLocalHostBindingSummary {
+    requirementKey: string;
+    requirementKind: ProjectLaunchRequirementKind;
+    type: string;
+    provider: string | null;
+    alias: string | null;
+    mode: 'team_owned' | 'treeseed_managed' | 'none';
+    displayName: string;
+}
+export interface ParseProjectLaunchHostBindingSpecsOptions {
+    specs?: string | string[] | null;
+    launchRequirements?: TemplateLaunchRequirements | null;
+    selectedAt?: string;
+}
+export interface ParseProjectLaunchHostBindingSpecsResult {
+    hostBindings: Record<string, ProjectLaunchHostBindingInput>;
+    repositoryHosts: ProjectLaunchHostInventoryRecord[];
+    teamHosts: ProjectLaunchHostInventoryRecord[];
+    managedHosts: ProjectLaunchHostInventoryRecord[];
+    summaries: ProjectLaunchLocalHostBindingSummary[];
+    omitted: ProjectLaunchLocalHostBindingSummary[];
+}
+export declare function normalizeTemplateLaunchRequirements(value: unknown, label?: string): TemplateLaunchRequirements | undefined;
+export declare function validateTemplateLaunchRequirements(value: unknown, label?: string): void;
+export declare function normalizeProjectLaunchHostBindings(input: unknown): Mutable<Record<string, ProjectLaunchHostBindingInput>>;
+export declare function parseProjectLaunchHostBindingSpecs(options: ParseProjectLaunchHostBindingSpecsOptions): ParseProjectLaunchHostBindingSpecsResult;
+export declare function resolveProjectLaunchHostBindings(options: ResolveProjectLaunchHostBindingsOptions): ResolveProjectLaunchHostBindingsResult;