@treeseed/sdk 0.8.11 → 0.8.12

package/dist/control-plane.d.ts

@@ -1,4 +1,4 @@
-import type { AgentPoolAutoscalePolicy, ApprovalRequest, CapacityPlan, CapacityReservation, CapacityRoutingDecision, CreateApprovalRequestRequest, CreateCapacityReservationRequest, CreateCapacityRoutingDecisionRequest, ProjectDeploymentKind, ProjectDeploymentStatus, ProjectEnvironmentName, ProjectInfrastructureResourceKind, ProjectInfrastructureResourceProvider, RecordCapacityUsageRequest, TreeseedHostingKind, TreeseedHostingRegistration } from './sdk-types.ts';
+import type { AgentPoolAutoscalePolicy, ApprovalRequest, CapacityPlan, CapacityReservation, CapacityRoutingDecision, CreateApprovalRequestRequest, CreateCapacityReservationRequest, CreateCapacityRoutingDecisionRequest, CreateTaskEstimateRequest, ProjectDeploymentKind, ProjectDeploymentStatus, ProjectEnvironmentName, ProjectInfrastructureResourceKind, ProjectInfrastructureResourceProvider, RecordCapacityUsageRequest, TaskEstimate, TreeseedHostingKind, TreeseedHostingRegistration } from './sdk-types.ts';
 import type { TreeseedDeployConfig } from './platform/contracts.ts';
 export type ControlPlaneReporterKind = 'noop' | 'market_http' | 'self_http';
 export interface ControlPlaneEnvironmentReport {
@@ -80,6 +80,7 @@ export interface ControlPlaneReporter {
     reportWorkdaySummary(input: ControlPlaneWorkdaySummaryReport): Promise<void>;
     getProjectCapacityPlan(environment?: ProjectEnvironmentName | 'local' | null): Promise<CapacityPlan | null>;
     createCapacityReservation(input: CreateCapacityReservationRequest): Promise<CapacityReservation | null>;
+    reportCapacityEstimate(input: CreateTaskEstimateRequest): Promise<TaskEstimate | null>;
     reportCapacityUsage(input: RecordCapacityUsageRequest): Promise<void>;
     reportCapacityRoutingDecision(input: CreateCapacityRoutingDecisionRequest): Promise<CapacityRoutingDecision | null>;
     createApprovalRequest(input: CreateApprovalRequestRequest): Promise<ApprovalRequest | null>;

package/dist/control-plane.js

@@ -47,6 +47,9 @@ class NoopControlPlaneReporter {
   async createCapacityReservation() {
     return null;
   }
+  async reportCapacityEstimate() {
+    return null;
+  }
   async reportCapacityUsage() {
   }
   async reportCapacityRoutingDecision() {
@@ -134,6 +137,10 @@ class HttpControlPlaneReporter {
     if (!this.projectId) return null;
     return this.request("POST", `/v1/projects/${this.projectId}/runner/capacity/reservations`, input);
   }
+  async reportCapacityEstimate(input) {
+    if (!this.projectId) return null;
+    return this.request("POST", `/v1/projects/${this.projectId}/runner/capacity/estimates`, input);
+  }
   async reportCapacityUsage(input) {
     if (!this.projectId) return;
     await this.request("POST", `/v1/projects/${this.projectId}/runner/capacity/usage`, input);

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export { ContentGraphRuntime } from './graph.ts';
 export { projectConnectionModeFromHosting } from './sdk-types.ts';
 export { createControlPlaneReporter } from './control-plane.ts';
 export { ControlPlaneClient } from './control-plane-client.ts';
-export { reservationHasCapacity, reserveCreditsForEstimate, routeAndReserveCapacity, scoreCapacityLane, selectBestCapacityLane, settleCapacityActuals, createReservationReleaseEntry, summarizeCapacityPlan, summarizeProjectCapacityPlan, summarizeTeamCapacityPlan, } from './capacity.ts';
+export { DEFAULT_EXECUTION_PROFILE_ID, DEFAULT_EXECUTION_PROFILES, DEFAULT_TASK_ADMISSION_POLICY, buildTaskEstimateProfileFromActuals, computeWorkdayBudgetEnvelope, decideTaskAdmission, estimateAttentionForTask, estimateConfidenceFromProfile, estimateLearningPercentile, estimateLearningVariance, estimateForClassification, estimateProfileConfidenceScore, estimateUtilityForTask, isInterruptedUsageActual, normalizeHybridExecutionPlan, mutationRequiresRepositoryClaim, normalizePlanningPolicy, normalizePredictiveReservePolicy, normalizeTaskPlanProposal, normalizeExecutionProfile, normalizeAttentionPolicy, normalizeTaskAdmissionPolicy, normalizeUtilityPolicy, predictReserveForCapacityPlan, progressivelyAdmitPlanProposal, rankPlannedTaskNodes, reservationHasCapacity, reserveCreditsForEstimate, routeAndReserveCapacity, scoreCapacityLane, selectBestCapacityLane, selectTaskEstimateProfile, settleCapacityActuals, shouldInterruptForCapacity, synthesizePlanEstimate, createReservationReleaseEntry, summarizeCapacityPlan, summarizeProjectCapacityPlan, summarizeTeamCapacityPlan, validateTaskPlanProposal, } from './capacity.ts';
 export { executeKnowledgeHubProviderLaunch, validateKnowledgeHubProviderLaunchPrerequisites, } from './operations/services/hub-provider-launch.ts';
 export { createKnowledgeHubRepositories, defaultHubContentResolutionPolicy, executeKnowledgeHubLaunch, normalizeKnowledgeHubLaunchIntent, planKnowledgeHubLaunch, planKnowledgeHubRepositories, validateRepositoryHost, type HubContentResolutionPolicy, type KnowledgeHubLaunchIntent, type KnowledgeHubLaunchPhase, type KnowledgeHubLaunchPlan, type KnowledgeHubLaunchResult, type KnowledgeHubRepositoryPlan, type RepositoryHost, } from './operations/services/hub-launch.ts';
 export { ensureRailwayEnvironment, ensureRailwayProject, ensureRailwayService, getRailwayAuthProfile, listRailwayEnvironments, listRailwayProjects, listRailwayServices, listRailwayVariables, railwayGraphqlRequest, resolveRailwayApiToken, resolveRailwayApiUrl, resolveRailwayWorkspace, resolveRailwayWorkspaceContext, upsertRailwayVariables, } from './operations/services/railway-api.ts';
@@ -34,11 +34,11 @@ export { TreeseedWorkflowSdk } from './workflow.ts';
 export * from './db/index.ts';
 export { collectTreeseedReconcileStatus, createTreeseedReconcileRegistry, deriveTreeseedDesiredUnits, destroyTreeseedTargetUnits, observeTreeseedUnits, planTreeseedReconciliation, reconcileTreeseedTarget, } from './reconcile/index.ts';
 export { getTreeseedVerifyDriverStatus, runTreeseedVerifyDriver } from './verification.ts';
-export type { KnowledgeHubProviderLaunchPreflightReport, KnowledgeHubProviderLaunchFailurePhase, KnowledgeHubProviderLaunchInput, KnowledgeHubProviderLaunchResult, AgentMessageKind, AgentMessageRecord, AgentStatusRecord, DirectBoardItemSummary, InboxItem, ProjectJobStatus, 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, WorkdayRequest, WorkdayManagerLease, WorkerRunner, WorkerRunnerState, RepositoryClaim, TaskCreditWeight, TaskCreditBudget, WorkdayPolicy, PrioritySnapshotItem, PrioritySnapshot, TaskCreditLedgerEntry, ApprovalRequest, CapacityBusinessModel, CapacityGrant, CapacityGrantScope, CapacityLedgerEntry, CapacityLaneUnit, CapacityPlan, CapacityProvider, CapacityProviderHost, CapacityProviderKind, CapacityProviderLane, CapacityReservation, CapacityRoutingDecision, CapacityTaskExecutionEnvelope, CreateApprovalRequestRequest, CreateCapacityReservationRequest, CreateCapacityRoutingDecisionRequest, CreateTaskEstimateRequest, CreateTaskUsageActualRequest, RecordCapacityUsageRequest, TaskEstimate, TaskEstimateProfile, TaskUsageActual, UpsertCapacityGrantRequest, UpsertCapacityProviderHostRequest, UpsertCapacityProviderLaneRequest, UpsertCapacityProviderRequest, ScaleDecision, RunnerScaleDecision, TeamStorageLocator, TeamWebHost, TeamWebHostOwnership, TeamWebHostProvider, EncryptedWebHostPayload, UpsertAgentPoolRequest, UpsertCatalogArtifactVersionRequest, UpsertCatalogItemRequest, UpsertProjectEnvironmentRequest, UpsertProjectHostingRequest, UpsertProjectInfrastructureResourceRequest, UpsertTeamStorageLocatorRequest, UpsertTeamWebHostRequest, CreateProjectDeploymentRequest, RecordAgentPoolRegistrationRequest, SdkCreateWorkdayRequest, SdkClaimWorkdayManagerLeaseRequest, SdkReleaseWorkdayManagerLeaseRequest, SdkRecordWorkerRunnerRequest, SdkRecordRepositoryClaimRequest, SdkRecordRunnerScaleDecisionRequest, SdkUpdateWorkDayGraphRequest, WorkerPoolScaleResult, WorkerPoolScaler, } from './sdk-types.ts';
+export type { KnowledgeHubProviderLaunchPreflightReport, KnowledgeHubProviderLaunchFailurePhase, KnowledgeHubProviderLaunchInput, KnowledgeHubProviderLaunchResult, AgentMessageKind, AgentMessageRecord, AgentStatusRecord, DirectBoardItemSummary, InboxItem, ProjectJobStatus, 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, WorkdayRequest, WorkdayManagerLease, WorkerRunner, WorkerRunnerState, RepositoryClaim, TaskCreditWeight, TaskCreditBudget, WorkdayPolicy, PrioritySnapshotItem, PrioritySnapshot, TaskCreditLedgerEntry, ApprovalRequest, CapacityBusinessModel, CapacityGrant, CapacityGrantScope, CapacityLedgerEntry, CapacityLaneUnit, CapacityPlan, CapacityProvider, CapacityProviderHost, CapacityProviderKind, CapacityProviderLane, CapacityReservation, CapacityRoutingDecision, CapacityTaskExecutionEnvelope, CanonicalTaskState, CreateApprovalRequestRequest, CreateCapacityReservationRequest, CreateCapacityRoutingDecisionRequest, CreateTaskEstimateRequest, CreateTaskUsageActualRequest, ExecutionProfile, HybridExecutionPhase, HybridExecutionPlan, PlannedTaskNode, PlanningAdmissionResult, PlanningPolicy, PredictiveReservePolicy, RecordCapacityUsageRequest, RepositoryWorkState, ReservePrediction, TaskAdmissionDecision, TaskAdmissionOutcome, TaskAdmissionPolicy, TaskClassification, TaskEstimate, TaskEstimateProfile, TaskCheckpointArtifact, TaskConcurrencyClass, TaskPlanProposal, TaskMutationScope, TaskRiskClass, TaskUsageActual, UtilityEstimate, UtilityPolicy, UpsertCapacityGrantRequest, UpsertCapacityProviderHostRequest, UpsertCapacityProviderLaneRequest, UpsertCapacityProviderRequest, ScaleDecision, RunnerScaleDecision, TeamStorageLocator, TeamWebHost, TeamWebHostOwnership, TeamWebHostProvider, EncryptedWebHostPayload, UpsertAgentPoolRequest, UpsertCatalogArtifactVersionRequest, UpsertCatalogItemRequest, UpsertProjectEnvironmentRequest, UpsertProjectHostingRequest, UpsertProjectInfrastructureResourceRequest, UpsertTeamStorageLocatorRequest, UpsertTeamWebHostRequest, CreateProjectDeploymentRequest, RecordAgentPoolRegistrationRequest, SdkCreateWorkdayRequest, SdkClaimWorkdayManagerLeaseRequest, SdkReleaseWorkdayManagerLeaseRequest, SdkRecordWorkerRunnerRequest, SdkRecordRepositoryClaimRequest, SdkRecordRunnerScaleDecisionRequest, SdkUpdateWorkDayGraphRequest, WorkerPoolScaleResult, WorkerPoolScaler, } from './sdk-types.ts';
 export type * from './project-workflow.ts';
 export type { ControlPlaneAgentPoolHeartbeat, ControlPlaneDeploymentReport, ControlPlaneEnvironmentReport, ControlPlaneReporter, ControlPlaneReporterKind, ControlPlaneResourceReport, ControlPlaneScaleDecisionReport, ControlPlaneWorkdaySummaryReport, } from './control-plane.ts';
 export type { ControlPlaneClientOptions } from './control-plane-client.ts';
-export type { CapacityEstimateInput, CapacityLaneCandidate, CapacityLaneScore, } from './capacity.ts';
+export type { AdmissionEstimateInput, CapacityInterruptionInput, CapacityEstimateInput, CapacityLaneCandidate, CapacityLaneScore, CapacityTaskEstimate, AttentionEstimate, AttentionPolicy, CapacityRoutePressure, RouteAndReserveCandidate, RouteAndReserveResult, TaskAdmissionInput, WorkdayBudgetEnvelopeInput, } from './capacity.ts';
 export type { TreeseedFieldAliasBinding, TreeseedFieldAliasRegistry, } from './field-aliases.ts';
 export type * from './operations-types.ts';
 export type * from './workflow.ts';

package/dist/index.js

@@ -4,16 +4,46 @@ import { projectConnectionModeFromHosting } from "./sdk-types.js";
 import { createControlPlaneReporter } from "./control-plane.js";
 import { ControlPlaneClient } from "./control-plane-client.js";
 import {
+  DEFAULT_EXECUTION_PROFILE_ID,
+  DEFAULT_EXECUTION_PROFILES,
+  DEFAULT_TASK_ADMISSION_POLICY,
+  buildTaskEstimateProfileFromActuals,
+  computeWorkdayBudgetEnvelope,
+  decideTaskAdmission,
+  estimateAttentionForTask,
+  estimateConfidenceFromProfile,
+  estimateLearningPercentile,
+  estimateLearningVariance,
+  estimateForClassification,
+  estimateProfileConfidenceScore,
+  estimateUtilityForTask,
+  isInterruptedUsageActual,
+  normalizeHybridExecutionPlan,
+  mutationRequiresRepositoryClaim,
+  normalizePlanningPolicy,
+  normalizePredictiveReservePolicy,
+  normalizeTaskPlanProposal,
+  normalizeExecutionProfile,
+  normalizeAttentionPolicy,
+  normalizeTaskAdmissionPolicy,
+  normalizeUtilityPolicy,
+  predictReserveForCapacityPlan,
+  progressivelyAdmitPlanProposal,
+  rankPlannedTaskNodes,
   reservationHasCapacity,
   reserveCreditsForEstimate,
   routeAndReserveCapacity,
   scoreCapacityLane,
   selectBestCapacityLane,
+  selectTaskEstimateProfile,
   settleCapacityActuals,
+  shouldInterruptForCapacity,
+  synthesizePlanEstimate,
   createReservationReleaseEntry,
   summarizeCapacityPlan,
   summarizeProjectCapacityPlan,
-  summarizeTeamCapacityPlan
+  summarizeTeamCapacityPlan,
+  validateTaskPlanProposal
 } from "./capacity.js";
 import {
   executeKnowledgeHubProviderLaunch,
@@ -223,7 +253,10 @@ export {
   CloudflareQueuePushClient,
   ContentGraphRuntime,
   ControlPlaneClient,
+  DEFAULT_EXECUTION_PROFILES,
+  DEFAULT_EXECUTION_PROFILE_ID,
   DEFAULT_GRAPH_RANKING_PROVIDER,
+  DEFAULT_TASK_ADMISSION_POLICY,
   DEFAULT_TREESEED_MARKET_BASE_URL,
   EDITORIAL_PREVIEW_COOKIE,
   MODEL_REGISTRY,
@@ -260,6 +293,7 @@ export {
   buildKnowledgePackMarketPackage,
   buildModelRegistry,
   buildScopedModelRegistry,
+  buildTaskEstimateProfileFromActuals,
   buildTemplateMarketPackage,
   canonicalizeFrontmatter,
   clearMarketSession,
@@ -267,6 +301,7 @@ export {
   collectTreeseedReconcileStatus,
   collectTreeseedToolStatus,
   compileDeclarativeContextQuery,
+  computeWorkdayBudgetEnvelope,
   createAgentOperationEvent,
   createControlPlaneReporter,
   createDefaultGraphRankingProvider,
@@ -279,6 +314,7 @@ export {
   createTreeseedManagedToolEnv,
   createTreeseedReconcileRegistry,
   decideAgentOperationPermission,
+  decideTaskAdmission,
   declarativeContextFormatToGraphView,
   declarativeContextPurposeToGraphStage,
   defaultHubContentResolutionPolicy,
@@ -288,6 +324,13 @@ export {
   ensureRailwayEnvironment,
   ensureRailwayProject,
   ensureRailwayService,
+  estimateAttentionForTask,
+  estimateConfidenceFromProfile,
+  estimateForClassification,
+  estimateLearningPercentile,
+  estimateLearningVariance,
+  estimateProfileConfidenceScore,
+  estimateUtilityForTask,
   executeKnowledgeHubLaunch,
   executeKnowledgeHubProviderLaunch,
   executeSdkOperation,
@@ -301,6 +344,7 @@ export {
   importKnowledgePack,
   installTreeseedDependencies,
   isAgentOperationName,
+  isInterruptedUsageActual,
   isTeamScopedR2ContentEnabled,
   listIntegratedMarketCatalog,
   listRailwayEnvironments,
@@ -315,15 +359,24 @@ export {
   loadTreeseedManifest,
   loadTreeseedTenantManifest,
   mergeModelRegistries,
+  mutationRequiresRepositoryClaim,
   normalizeAgentCliOptions,
   normalizeAliasedRecord,
+  normalizeAttentionPolicy,
+  normalizeExecutionProfile,
   normalizeFilterFields,
+  normalizeHybridExecutionPlan,
   normalizeKnowledgeHubLaunchIntent,
   normalizeMutationData,
+  normalizePlanningPolicy,
+  normalizePredictiveReservePolicy,
   normalizeProjectJobStatus,
   normalizeRecordToCanonicalShape,
   normalizeRemoteJobStatus,
   normalizeSortFields,
+  normalizeTaskAdmissionPolicy,
+  normalizeTaskPlanProposal,
+  normalizeUtilityPolicy,
   observeTreeseedUnits,
   parseGraphDsl,
   parsePublishedCollectionIndex,
@@ -333,9 +386,12 @@ export {
   planKnowledgeHubLaunch,
   planKnowledgeHubRepositories,
   planTreeseedReconciliation,
+  predictReserveForCapacityPlan,
   preprocessAliasedRecord,
+  progressivelyAdmitPlanProposal,
   projectConnectionModeFromHosting,
   railwayGraphqlRequest,
+  rankPlannedTaskNodes,
   readCanonicalFieldValue,
   readPublishedContentManifest,
   readPublishedOverlayManifest,
@@ -371,19 +427,23 @@ export {
   runTreeseedVerifyDriver,
   scoreCapacityLane,
   selectBestCapacityLane,
+  selectTaskEstimateProfile,
   setActiveMarketProfile,
   setMarketSession,
   settleCapacityActuals,
+  shouldInterruptForCapacity,
   signEditorialPreviewToken,
   summarizeCapacityPlan,
   summarizeProjectCapacityPlan,
   summarizeTeamCapacityPlan,
+  synthesizePlanEstimate,
   tenantFeatureEnabled,
   tenantModelRendered,
   upsertRailwayVariables,
   validateKnowledgeHubProviderLaunchPrerequisites,
   validateModelFieldAliases,
   validateRepositoryHost,
+  validateTaskPlanProposal,
   verifyArtifactBytes,
   verifyEditorialPreviewToken,
   writeMarketRegistryState

package/dist/operations/services/d1-migration.js

@@ -1,4 +1,5 @@
 import { existsSync, readdirSync } from "node:fs";
+import { readFileSync } from "node:fs";
 import { resolve } from "node:path";
 import { spawnSync } from "node:child_process";
 import { resolveWranglerBin } from "./runtime-tools.js";
@@ -98,6 +99,28 @@ function markMigrationApplied({ cwd, wranglerConfig, persistTo, migration }) {
     command: `INSERT OR REPLACE INTO treeseed_schema_migrations (name, applied_at) VALUES ('${migration.replace(/'/g, "''")}', datetime('now'));`
   });
 }
+function tableColumns({ cwd, wranglerConfig, persistTo, tableName }) {
+  const result = executeSqlCommand({
+    cwd,
+    wranglerConfig,
+    persistTo,
+    capture: true,
+    command: `PRAGMA table_info(${tableName.replace(/[^A-Za-z0-9_]/g, "")});`
+  });
+  const parsed = parseWranglerJsonOutput(result.stdout);
+  const rows = (Array.isArray(parsed) ? parsed : [parsed]).flatMap((entry) => entry.results ?? []);
+  return new Set(rows.map((row) => row.name).filter(Boolean));
+}
+function migrationAlreadySatisfied({ cwd, wranglerConfig, persistTo, filePath }) {
+  const sql = readFileSync(filePath, "utf8");
+  if (!sql.includes("execution_profile_id") || !sql.includes("task_estimate_profiles")) {
+    return false;
+  }
+  const estimateColumns = tableColumns({ cwd, wranglerConfig, persistTo, tableName: "task_estimates" });
+  const actualColumns = tableColumns({ cwd, wranglerConfig, persistTo, tableName: "task_usage_actuals" });
+  const profileColumns = tableColumns({ cwd, wranglerConfig, persistTo, tableName: "task_estimate_profiles" });
+  return estimateColumns.has("execution_profile_id") && actualColumns.has("execution_profile_id") && profileColumns.has("execution_profile_id") && profileColumns.has("completed_sample_count") && profileColumns.has("interrupted_sample_count") && profileColumns.has("confidence_score");
+}
 function runLocalD1Migrations({ cwd, wranglerConfig, migrationsRoot, persistTo }) {
   ensureSchemaMigrationsTable({ cwd, wranglerConfig, persistTo });
   const appliedMigrations = loadAppliedMigrations({ cwd, wranglerConfig, persistTo });
@@ -111,6 +134,10 @@ function runLocalD1Migrations({ cwd, wranglerConfig, migrationsRoot, persistTo }
       console.error(`Unable to find migration file at ${filePath}.`);
       process.exit(1);
     }
+    if (migrationAlreadySatisfied({ cwd, wranglerConfig, persistTo, filePath })) {
+      markMigrationApplied({ cwd, wranglerConfig, persistTo, migration });
+      continue;
+    }
     executeSqlFile({ cwd, wranglerConfig, filePath, persistTo });
     markMigrationApplied({ cwd, wranglerConfig, persistTo, migration });
   }

package/dist/sdk-types.d.ts

@@ -412,6 +412,224 @@ export type CapacityReservationState = 'reserved' | 'consuming' | 'consumed' | '
 export type CapacityEstimatePhase = 'intent' | 'discovery' | 'plan' | 'execution' | 'actual';
 export type CapacityEstimateConfidence = 'low' | 'medium' | 'high';
 export type CapacityApprovalState = 'pending' | 'approved' | 'rejected' | 'expired' | 'superseded';
+export type TaskRiskClass = 'low' | 'medium' | 'high';
+export type TaskMutationScope = 'none' | 'repository_read' | 'repository_write' | 'production';
+export type TaskConcurrencyClass = 'read_only' | 'repository_claim' | 'exclusive_project' | 'human_attention';
+export type TaskAdmissionOutcome = 'admitted' | 'planning_required' | 'approval_required' | 'budget_blocked' | 'deferred' | 'rejected';
+export type CanonicalTaskState = 'pending' | 'queued' | 'claimed' | 'running' | 'completed' | 'failed' | 'waiting' | 'paused_for_approval' | 'checkpointing' | 'checkpointed' | 'continuation_required' | 'rollback_required' | 'rollback_complete' | 'provider_exhausted' | 'reservation_exhausted';
+export type RepositoryWorkState = 'clean' | 'claimed_dirty' | 'checkpointed_dirty' | 'parked_dirty' | 'rollback_required';
+export interface TaskClassification {
+    taskSignature: string;
+    risk: TaskRiskClass;
+    mutationScope: TaskMutationScope;
+    concurrencyClass: TaskConcurrencyClass;
+    expectedFanout: number;
+    confidence: CapacityEstimateConfidence;
+    requiresPlanning: boolean;
+    requiresApproval: boolean;
+    features?: Record<string, unknown>;
+}
+export interface ExecutionProfile {
+    id: string;
+    providerId?: string | null;
+    laneId?: string | null;
+    modelFamily?: string | null;
+    modelClass?: string | null;
+    contextWindowTokens?: number | null;
+    qualityWeight: number;
+    costMultiplier: number;
+    latencyClass: 'low' | 'medium' | 'high' | string;
+    concurrencyClass?: TaskConcurrencyClass | null;
+    quotaBehavior?: 'api_metered' | 'subscription_limited' | 'compute_bound' | 'attention_bound' | string | null;
+    metadata?: Record<string, unknown>;
+}
+export interface AttentionEstimate {
+    attentionWeight: number;
+    coordinationWeight: number;
+    totalAttentionWeight: number;
+    estimatedContextTokens: number;
+    requiredContextTokens: number;
+    source: string;
+    metadata?: Record<string, unknown>;
+}
+export interface AttentionPolicy {
+    maxAttentionLoad: number | null;
+    reserveAttentionPercent: number;
+    maxContextTokens: number | null;
+    maxContextSaturationPercent: number;
+    coordinationOverheadFactor: number;
+}
+export interface UtilityEstimate {
+    utilityValue: number;
+    maintenanceValue: number;
+    deadlinePressure: number;
+    successProbability: number;
+    qualityScore: number;
+    riskPenalty: number;
+    utilityScore: number;
+    utilityPerCredit: number;
+    source: string;
+    metadata?: Record<string, unknown>;
+}
+export interface UtilityPolicy {
+    minimumUtilityScore: number | null;
+    minimumUtilityPerCredit: number | null;
+    riskPenaltyFactor: number;
+    deadlineWindowHours: number;
+    maintenanceWeight: number;
+    priorityWeight: number;
+}
+export interface PredictiveReservePolicy {
+    enabled: boolean;
+    baseReservePercent: number;
+    maxReservePercent: number;
+    incidentReservePercent: number;
+    triggerBurstReservePercent: number;
+    deploymentWindowReservePercent: number;
+    providerDegradationReservePercent: number;
+    quotaPressureReservePercent: number;
+}
+export interface ReservePrediction {
+    reservePercent: number;
+    reserveCredits: number;
+    activelyAllocatableCredits: number;
+    reasons: string[];
+    signals: Record<string, unknown>;
+}
+export interface HybridExecutionPhase {
+    id: string;
+    kind: 'planning' | 'implementation' | 'review' | 'human_escalation' | string;
+    executionProfileId: string;
+    taskSignature?: string | null;
+    required: boolean;
+    admissionRequired: boolean;
+    mutationAllowed: boolean;
+    metadata?: Record<string, unknown>;
+}
+export interface HybridExecutionPlan {
+    schemaVersion: 1;
+    planId: string;
+    phases: HybridExecutionPhase[];
+    escalationPolicy?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+export interface WorkdayBudgetEnvelope {
+    dailyCreditBudget: number;
+    usedCredits: number;
+    queuedCredits: number;
+    reserveBufferCredits: number;
+    recoveryBudgetCredits: number;
+    activelyAllocatableCredits: number;
+    remainingCredits: number;
+}
+export interface TaskAdmissionPolicy {
+    planningThresholdCredits: number;
+    approvalThresholdCredits: number;
+    reserveBufferPercent: number;
+    recoveryBudgetCredits: number;
+    maxDownstreamTasks: number;
+    maxPlanningDepth: number;
+    maxAdmittedPlanTasksPerCycle: number;
+    planningTaskSignature: string;
+    allowBackfill?: boolean;
+    maxAttentionLoad?: number | null;
+    reserveAttentionPercent?: number | null;
+    maxContextTokens?: number | null;
+    maxContextSaturationPercent?: number | null;
+    coordinationOverheadFactor?: number | null;
+    predictiveReservePolicy?: Partial<PredictiveReservePolicy> | null;
+    utilityPolicy?: Partial<UtilityPolicy> | null;
+}
+export interface TaskAdmissionDecision {
+    outcome: TaskAdmissionOutcome;
+    taskSignature: string;
+    estimatedCreditsP50: number;
+    estimatedCreditsP90: number;
+    reservedCredits: number;
+    baseReservedCredits?: number;
+    executionProfileId?: string | null;
+    costMultiplier?: number | null;
+    reasons: string[];
+    requiresApproval: boolean;
+    requiresPlanning: boolean;
+    budget: WorkdayBudgetEnvelope;
+    policySnapshot: TaskAdmissionPolicy;
+    metadata?: Record<string, unknown>;
+}
+export interface TaskCheckpointArtifact {
+    id?: string;
+    taskId: string;
+    checkpointId?: string;
+    branch?: string | null;
+    baseCommit?: string | null;
+    currentCommit?: string | null;
+    currentGoal?: string | null;
+    currentPhase?: string | null;
+    filesChanged: string[];
+    commandsRun: string[];
+    testStatus?: 'not_run' | 'passing' | 'failing' | 'unknown' | string;
+    knownFailures: string[];
+    completedWork: string[];
+    remainingWorkEstimate?: {
+        p50: number;
+        p90: number;
+    } | null;
+    rollbackStrategy?: string | null;
+    continuationStrategy?: string | null;
+    repositoryState: RepositoryWorkState;
+    createdAt: string;
+    metadata?: Record<string, unknown>;
+}
+export interface PlannedTaskNode {
+    id?: string;
+    type: string;
+    agentId?: string | null;
+    title?: string | null;
+    priority?: number | null;
+    taskSignature?: string | null;
+    payload?: Record<string, unknown>;
+    estimatedCreditsP50?: number | null;
+    estimatedCreditsP90?: number | null;
+    risk?: TaskRiskClass | null;
+    mutationScope?: TaskMutationScope | null;
+    confidence?: CapacityEstimateConfidence | null;
+    expectedFanout?: number | null;
+    requiresApproval?: boolean | null;
+    requiresPlanning?: boolean | null;
+    dependsOn?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface TaskPlanProposal {
+    schemaVersion: 1;
+    planId: string;
+    sourceTaskId?: string | null;
+    parentTaskId?: string | null;
+    planningDepth: number;
+    tasks: PlannedTaskNode[];
+    totalEstimatedCreditsP50: number;
+    totalEstimatedCreditsP90: number;
+    createdAt?: string | null;
+    metadata?: Record<string, unknown>;
+}
+export interface PlanningPolicy {
+    maxDownstreamTasks: number;
+    maxPlanningDepth: number;
+    maxAdmittedPlanTasksPerCycle: number;
+    planningTaskSignature: string;
+}
+export interface PlanningAdmissionResult {
+    proposal: TaskPlanProposal;
+    admitted: PlannedTaskNode[];
+    deferred: PlannedTaskNode[];
+    rejected: Array<{
+        node: PlannedTaskNode;
+        reasons: string[];
+    }>;
+    totalEstimatedCreditsP50: number;
+    totalEstimatedCreditsP90: number;
+    admittedCreditsP90: number;
+    reasons: string[];
+}
 export interface CapacityProvider {
     id: string;
     teamId: string | null;
@@ -536,6 +754,7 @@ export interface TaskEstimate {
     projectId: string;
     estimatePhase: CapacityEstimatePhase;
     taskSignature: string;
+    executionProfileId: string;
     confidence: CapacityEstimateConfidence;
     estimatedCreditsP50: number;
     estimatedCreditsP90: number;
@@ -555,6 +774,7 @@ export interface TaskUsageActual {
     workDayId: string | null;
     projectId: string;
     taskSignature: string;
+    executionProfileId: string;
     capacityProviderId: string | null;
     laneId: string | null;
     businessModel: CapacityBusinessModel | string;
@@ -577,7 +797,10 @@ export interface TaskUsageActual {
 }
 export interface TaskEstimateProfile {
     taskSignature: string;
+    executionProfileId: string;
     sampleCount: number;
+    completedSampleCount?: number;
+    interruptedSampleCount?: number;
     inputTokensP50: number | null;
     inputTokensP90: number | null;
     outputTokensP50: number | null;
@@ -588,6 +811,12 @@ export interface TaskEstimateProfile {
     filesChangedP90: number | null;
     creditsP50: number | null;
     creditsP90: number | null;
+    creditsVariance?: number | null;
+    confidenceScore?: number | null;
+    outlierCount?: number;
+    partialCredits?: number | null;
+    firstSampleAt?: string | null;
+    lastSampleAt?: string | null;
     updatedAt: string;
 }
 export interface ApprovalRequest {
@@ -1690,6 +1919,7 @@ export interface CreateTaskEstimateRequest {
     projectId: string;
     estimatePhase: CapacityEstimatePhase;
     taskSignature: string;
+    executionProfileId?: string | null;
     confidence: CapacityEstimateConfidence;
     estimatedCreditsP50: number;
     estimatedCreditsP90: number;
@@ -1708,6 +1938,7 @@ export interface CreateTaskUsageActualRequest {
     workDayId?: string | null;
     projectId: string;
     taskSignature: string;
+    executionProfileId?: string | null;
     capacityProviderId?: string | null;
     laneId?: string | null;
     businessModel: CapacityBusinessModel | string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treeseed/sdk",
-  "version": "0.8.11",
+  "version": "0.8.12",
   "description": "Shared Treeseed SDK for content-backed and D1-backed object models.",
   "license": "AGPL-3.0-only",
   "repository": {