@treeseed/sdk 0.5.3 → 0.6.0

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export { projectConnectionModeFromHosting } from './sdk-types.ts';
 export { createControlPlaneReporter } from './control-plane.ts';
 export { ControlPlaneClient } from './control-plane-client.ts';
 export { executeKnowledgeCoopManagedLaunch, validateKnowledgeCoopManagedLaunchPrerequisites, } from './operations/services/knowledge-coop-launch.ts';
+export { ensureRailwayEnvironment, ensureRailwayProject, ensureRailwayService, getRailwayAuthProfile, listRailwayEnvironments, listRailwayProjects, listRailwayServices, listRailwayVariables, railwayGraphqlRequest, resolveRailwayApiToken, resolveRailwayApiUrl, resolveRailwayWorkspace, resolveRailwayWorkspaceContext, upsertRailwayVariables, } from './operations/services/railway-api.ts';
 export { buildKnowledgeCoopKnowledgePackPackage, buildKnowledgeCoopTemplatePackage, importKnowledgeCoopKnowledgePack, } from './operations/services/knowledge-coop-packaging.ts';
 export { KNOWLEDGE_COOP_AGENT_MESSAGE_KINDS, KNOWLEDGE_COOP_JOB_STATUSES, KNOWLEDGE_COOP_RELEASE_STATES, KNOWLEDGE_COOP_SHARE_PACKAGE_STATES, KNOWLEDGE_COOP_TEAM_CAPABILITIES, KNOWLEDGE_COOP_WORKSTREAM_STATES, normalizeKnowledgeCoopJobStatus, normalizeRemoteJobStatus, } from './knowledge-coop.ts';
 export { PUBLISHED_CONTENT_MANIFEST_SCHEMA_VERSION, EDITORIAL_PREVIEW_COOKIE, TeamScopedR2OverlayContentRuntimeProvider, TeamScopedR2OverlayContentPublishProvider, createTeamScopedR2OverlayContentRuntimeProvider, createTeamScopedR2OverlayContentPublishProvider, isTeamScopedR2ContentEnabled, parsePublishedCollectionIndex, parsePublishedContentManifest, parsePublishedOverlayManifest, readPublishedContentManifest, readPublishedOverlayManifest, resolveCloudflareR2Bucket, resolvePublishedContentBucketBinding, resolvePublishedContentManifestKey, resolvePublishedContentPreviewRoot, resolvePublishedContentPreviewTtlHours, resolveTeamScopedContentLocator, signEditorialPreviewToken, verifyEditorialPreviewToken, } from './platform/published-content.ts';
@@ -23,6 +24,7 @@ export { TREESEED_REMOTE_CONTRACT_HEADER, TREESEED_REMOTE_CONTRACT_VERSION, Clou
 export { TRESEED_OPERATION_SPECS, findTreeseedOperation, listTreeseedOperationNames, } from './operations-registry.ts';
 export { TreeseedOperationsSdk } from './operations/runtime.ts';
 export { TreeseedWorkflowSdk } from './workflow.ts';
+export { collectTreeseedReconcileStatus, createTreeseedReconcileRegistry, deriveTreeseedDesiredUnits, destroyTreeseedTargetUnits, observeTreeseedUnits, planTreeseedReconciliation, reconcileTreeseedTarget, } from './reconcile/index.ts';
 export { getTreeseedVerifyDriverStatus, runTreeseedVerifyDriver } from './verification.ts';
 export type { KnowledgeCoopLaunchPreflightReport, KnowledgeCoopLaunchFailurePhase, KnowledgeCoopManagedLaunchInput, KnowledgeCoopManagedLaunchResult, AgentMessageKind, AgentMessageRecord, AgentStatusRecord, DirectBoardItemSummary, InboxItem, KnowledgeCoopJobStatus, LaunchProjectRequest, LaunchProjectResult, LinkedProjectRecordRef, ProjectConnectionStatus, ProjectOverviewSummary, ReleaseDetail, ReleaseState, ReleaseSummary, SharePackageState, SharePackageStatus, TeamCapability, TeamHomeSummary, TeamMemberSummary, WorkstreamDetail, WorkstreamEvent, WorkstreamState, WorkstreamSummary, SdkContentEntry, SdkDispatchCapability, SdkDispatchConfig, SdkDispatchCredentialSource, SdkDispatchExecutionClass, SdkDispatchNamespace, SdkDispatchPolicy, SdkDispatchRequest, SdkDispatchResult, SdkDispatchTarget, 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, ProjectCapabilityGrant, ProjectConnection, ProjectConnectionMode, ProjectDeployment, ProjectDeploymentKind, ProjectDeploymentStatus, ProjectEnvironment, ProjectExecutionOwner, ProjectHosting, ProjectInfrastructureResource, ProjectInfrastructureResourceKind, ProjectInfrastructureResourceProvider, ProjectRunnerRegistrationState, RemoteJob, RemoteJobEvent, RemoteJobStatus, AgentPool, AgentPoolAutoscalePolicy, AgentPoolRegistration, AgentPoolScaleDecision, AgentPoolStatus, CatalogArtifactVersion, CatalogItem, CatalogItemFilters, CatalogItemOfferMode, ProjectEnvironmentName, ProjectWorkdaySummary, TreeseedHostingKind, TreeseedHostingRegistration, PriorityOverride, WorkdayWindow, WorkdaySchedule, TaskCreditWeight, TaskCreditBudget, WorkdayPolicy, PrioritySnapshotItem, PrioritySnapshot, TaskCreditLedgerEntry, ScaleDecision, TeamStorageLocator, UpsertAgentPoolRequest, UpsertCatalogArtifactVersionRequest, UpsertCatalogItemRequest, UpsertProjectEnvironmentRequest, UpsertProjectHostingRequest, UpsertProjectInfrastructureResourceRequest, UpsertTeamStorageLocatorRequest, CreateProjectDeploymentRequest, RecordAgentPoolRegistrationRequest, WorkerPoolScaleResult, WorkerPoolScaler, } from './sdk-types.ts';
 export type * from './knowledge-coop.ts';

package/dist/index.js

@@ -7,6 +7,22 @@ import {
   executeKnowledgeCoopManagedLaunch,
   validateKnowledgeCoopManagedLaunchPrerequisites
 } from "./operations/services/knowledge-coop-launch.js";
+import {
+  ensureRailwayEnvironment,
+  ensureRailwayProject,
+  ensureRailwayService,
+  getRailwayAuthProfile,
+  listRailwayEnvironments,
+  listRailwayProjects,
+  listRailwayServices,
+  listRailwayVariables,
+  railwayGraphqlRequest,
+  resolveRailwayApiToken,
+  resolveRailwayApiUrl,
+  resolveRailwayWorkspace,
+  resolveRailwayWorkspaceContext,
+  upsertRailwayVariables
+} from "./operations/services/railway-api.js";
 import {
   buildKnowledgeCoopKnowledgePackPackage,
   buildKnowledgeCoopTemplatePackage,
@@ -115,6 +131,15 @@ import {
 } from "./operations-registry.js";
 import { TreeseedOperationsSdk } from "./operations/runtime.js";
 import { TreeseedWorkflowSdk } from "./workflow.js";
+import {
+  collectTreeseedReconcileStatus,
+  createTreeseedReconcileRegistry,
+  deriveTreeseedDesiredUnits,
+  destroyTreeseedTargetUnits,
+  observeTreeseedUnits,
+  planTreeseedReconciliation,
+  reconcileTreeseedTarget
+} from "./reconcile/index.js";
 import { getTreeseedVerifyDriverStatus, runTreeseedVerifyDriver } from "./verification.js";
 import { CloudflareHttpD1Database } from "./d1-http.js";
 export {
@@ -158,21 +183,33 @@ export {
   buildModelRegistry,
   buildScopedModelRegistry,
   canonicalizeFrontmatter,
+  collectTreeseedReconcileStatus,
   createControlPlaneReporter,
   createDefaultGraphRankingProvider,
   createFilesystemContentSource,
   createPublishedContentPipeline,
   createTeamScopedR2OverlayContentPublishProvider,
   createTeamScopedR2OverlayContentRuntimeProvider,
+  createTreeseedReconcileRegistry,
+  deriveTreeseedDesiredUnits,
+  destroyTreeseedTargetUnits,
+  ensureRailwayEnvironment,
+  ensureRailwayProject,
+  ensureRailwayService,
   executeKnowledgeCoopManagedLaunch,
   executeSdkOperation,
   findDispatchCapability,
   findSdkOperation,
   findTreeseedOperation,
+  getRailwayAuthProfile,
   getTenantContentRoot,
   getTreeseedVerifyDriverStatus,
   importKnowledgeCoopKnowledgePack,
   isTeamScopedR2ContentEnabled,
+  listRailwayEnvironments,
+  listRailwayProjects,
+  listRailwayServices,
+  listRailwayVariables,
   listSdkDispatchCapabilities,
   listSdkOperationNames,
   listTreeseedOperationNames,
@@ -188,16 +225,20 @@ export {
   normalizeRecordToCanonicalShape,
   normalizeRemoteJobStatus,
   normalizeSortFields,
+  observeTreeseedUnits,
   parseGraphDsl,
   parsePublishedCollectionIndex,
   parsePublishedContentManifest,
   parsePublishedOverlayManifest,
   parseTemplateCatalogResponse,
+  planTreeseedReconciliation,
   preprocessAliasedRecord,
   projectConnectionModeFromHosting,
+  railwayGraphqlRequest,
   readCanonicalFieldValue,
   readPublishedContentManifest,
   readPublishedOverlayManifest,
+  reconcileTreeseedTarget,
   resolveAliasedField,
   resolveCloudflareR2Bucket,
   resolveModelDefinition,
@@ -206,6 +247,10 @@ export {
   resolvePublishedContentManifestKey,
   resolvePublishedContentPreviewRoot,
   resolvePublishedContentPreviewTtlHours,
+  resolveRailwayApiToken,
+  resolveRailwayApiUrl,
+  resolveRailwayWorkspace,
+  resolveRailwayWorkspaceContext,
   resolveSdkRecordVersion,
   resolveTeamScopedContentLocator,
   resolveTreeseedTenantRoot,
@@ -213,6 +258,7 @@ export {
   signEditorialPreviewToken,
   tenantFeatureEnabled,
   tenantModelRendered,
+  upsertRailwayVariables,
   validateKnowledgeCoopManagedLaunchPrerequisites,
   validateModelFieldAliases,
   verifyEditorialPreviewToken

package/dist/operations/providers/default.js

@@ -212,7 +212,7 @@ class PreflightOperation extends BaseOperation {
       cwd: context.cwd,
       requireAuth: input.requireAuth ?? this.requireAuth
     });
-    const launch = input.launch === true || input.managedLaunch === true ? validateKnowledgeCoopManagedLaunchPrerequisites(context.cwd) : null;
+    const launch = input.launch === true || input.managedLaunch === true ? await validateKnowledgeCoopManagedLaunchPrerequisites(context.cwd) : null;
     const stdout = [formatCliPreflightReport(report)];
     if (launch) {
       stdout.push(

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

@@ -6,6 +6,21 @@ export declare const DEFAULT_TREESEED_API_BASE_URL = "https://api.treeseed.ai";
 export declare const DEFAULT_TEMPLATE_CATALOG_URL = "https://api.treeseed.ai/search/templates";
 export declare const TREESEED_TEMPLATE_CATALOG_URL_ENV = "TREESEED_TEMPLATE_CATALOG_URL";
 export declare const TREESEED_API_BASE_URL_ENV = "TREESEED_API_BASE_URL";
+export declare function inspectTreeseedPassphraseEnvDiagnostic(env?: NodeJS.ProcessEnv): {
+    envVar: string;
+    configured: boolean;
+    recommendedLaunch: string;
+};
+export declare function inspectTreeseedKeyAgentTransportDiagnostic(): Promise<{
+    socketPath: string;
+    pidPath: string;
+    socketPresent: boolean;
+    socketKind: "missing" | "socket" | "fifo" | "file" | "directory" | "other";
+    socketConnectable: boolean;
+    healthOk: boolean;
+    daemonPid: number | null;
+    lastError: string | null;
+}>;
 export declare function listDeprecatedTreeseedLocalEnvFiles(tenantRoot: any): string[];
 export declare function warnDeprecatedTreeseedLocalEnvFiles(tenantRoot: any, write?: (line: string) => void): string[];
 export declare function getTreeseedMachineConfigPaths(tenantRoot: any): {
@@ -212,7 +227,9 @@ export declare function applyTreeseedSafeRepairs(tenantRoot: string): TreeseedRe
 export declare function resolveTreeseedMachineEnvironmentValues(tenantRoot: any, scope: any): {};
 export declare function setTreeseedMachineEnvironmentValue(tenantRoot: any, scope: any, entry: any, value: any): any;
 export declare function collectTreeseedEnvironmentContext(tenantRoot: any): import("../../platform/environment.ts").TreeseedResolvedEnvironmentRegistry;
-export declare function collectTreeseedConfigSeedValues(tenantRoot: any, scope: any, env?: NodeJS.ProcessEnv): {};
+export declare function collectTreeseedConfigSeedValues(tenantRoot: any, scope: any, env?: NodeJS.ProcessEnv): {
+    [k: string]: unknown;
+};
 export declare function resolveTreeseedLaunchEnvironment({ tenantRoot, scope, baseEnv, overrides, }: {
     tenantRoot: string;
     scope: TreeseedConfigScope;
@@ -284,7 +301,7 @@ export declare function ensureTreeseedActVerificationTooling({ tenantRoot, insta
 export declare function checkTreeseedProviderConnections({ tenantRoot, scope, env }?: {
     scope?: string | undefined;
     env?: NodeJS.ProcessEnv | undefined;
-}): {
+}): Promise<{
     scope: string;
     ok: boolean;
     checks: {
@@ -293,17 +310,17 @@ export declare function checkTreeseedProviderConnections({ tenantRoot, scope, en
         detail: any;
     }[];
     issues: any[];
-};
+}>;
 export declare function formatTreeseedProviderConnectionReport(report: any): string;
 export declare function syncTreeseedGitHubEnvironment({ tenantRoot, scope, dryRun }?: {
     scope?: string | undefined;
     dryRun?: boolean | undefined;
-}): {
+}): Promise<{
     secrets: never[];
     variables: never[];
     repository: string;
     scope: string;
-};
+}>;
 export declare function syncTreeseedCloudflareEnvironment({ tenantRoot, scope, dryRun }?: {
     scope?: string | undefined;
     dryRun?: boolean | undefined;
@@ -329,7 +346,7 @@ export declare function syncTreeseedRailwayEnvironment({ tenantRoot, scope, dryR
         serviceId: string;
         rootDir: string;
         baseUrl: any;
-        environmentName: any;
+        environmentName: string;
         secrets: string[];
         variables: string[];
         dryRun: boolean;
@@ -338,46 +355,21 @@ export declare function syncTreeseedRailwayEnvironment({ tenantRoot, scope, dryR
 export declare function initializeTreeseedPersistentEnvironment({ tenantRoot, scope, dryRun }?: {
     scope?: string | undefined;
     dryRun?: boolean | undefined;
-}): {
+}): Promise<{
     scope: string;
     target: {
         kind: string;
         scope: string;
     };
     summary: {
-        target: any;
-        workerName: any;
-        siteUrl: any;
-        accountId: any;
-        pages: any;
-        formGuardKv: any;
-        sessionKv: any;
-        siteDataDb: any;
-        queue: any;
-        content: any;
-        webCache: {
-            webHost: any;
-            contentHost: any;
-            rulesManaged: boolean;
-            lastSyncedAt: any;
-            lastError: any;
-            policy: {
-                sourcePages: {
-                    paths: string[];
-                    browserTtlSeconds: number;
-                    edgeTtlSeconds: number;
-                    staleWhileRevalidateSeconds: number;
-                    staleIfErrorSeconds: number;
-                };
-                contentPages: Required<import("../../platform/contracts.ts").TreeseedWebCachePolicyConfig>;
-                r2PublishedObjects: Required<import("../../platform/contracts.ts").TreeseedWebCachePolicyConfig>;
-            };
-            deployPurge: any;
-            contentPurge: any;
-        };
+        target: import("../../reconcile/contracts.ts").TreeseedReconcileTarget;
+        units: import("../../reconcile/contracts.ts").TreeseedDesiredUnit[];
+        plans: import("../../reconcile/contracts.ts").TreeseedReconcilePlan[];
+        results: import("../../reconcile/contracts.ts").TreeseedReconcileResult[];
+        state: import("../../reconcile/contracts.ts").TreeseedReconcileStateRecord;
     };
     secrets: string[];
-};
+}>;
 declare function createConfigReadiness(values: any, validation: any): {
     github: {
         configured: boolean;
@@ -420,14 +412,29 @@ export declare function finalizeTreeseedConfig({ tenantRoot, scopes, sync, env,
     checkConnections?: boolean;
     initializePersistent?: boolean;
     onProgress?: (message: string) => void;
-}): {
+}): Promise<{
     scopes: ("local" | "staging" | "prod")[];
     synced: Record<string, unknown>;
-    initialized: Array<{
+    reconciled: Array<{
         scope: TreeseedConfigScope;
-        secrets: number;
         target: string;
+        units: number;
+        actions: Array<{
+            unitId: string;
+            unitType: string;
+            provider: string;
+            action: string;
+            verified: boolean;
+            missing: string[];
+            drifted: string[];
+        }>;
     }>;
+    deployed: Array<{
+        scope: TreeseedConfigScope;
+        branchBootstrap?: Record<string, unknown> | null;
+        result: Record<string, unknown>;
+    }>;
+    resourceInventoryByScope: Record<TreeseedConfigScope, Record<string, unknown>>;
     connectionChecks: ReturnType<typeof checkTreeseedProviderConnections>[];
     validationByScope: Record<TreeseedConfigScope, ReturnType<typeof validateTreeseedEnvironmentValues>>;
     readinessByScope: Record<TreeseedConfigScope, {
@@ -439,7 +446,7 @@ export declare function finalizeTreeseedConfig({ tenantRoot, scopes, sync, env,
         warnings: string[];
         checks: Record<string, unknown>;
     }>;
-};
+}>;
 export declare function collectTreeseedPrintEnvReport({ tenantRoot, scope, env, revealSecrets, }: {
     tenantRoot: string;
     scope: TreeseedConfigScope;