@treeseed/sdk 0.8.10 → 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/d1-store.js

@@ -120,6 +120,9 @@ class MemoryAgentDatabase {
     if (model === "task") {
       return [...this.tasks.values()];
     }
+    if (model === "task_output") {
+      return [...this.taskOutputs.values()].flat();
+    }
     if (model === "graph_run") {
       return [...this.graphRuns.values()];
     }
@@ -160,6 +163,9 @@ class MemoryAgentDatabase {
     if (request.model === "task") {
       return this.tasks.get(key) ?? null;
     }
+    if (request.model === "task_output") {
+      return [...this.taskOutputs.values()].flat().find((output) => output.id === key) ?? null;
+    }
     if (request.model === "graph_run") {
       return this.graphRuns.get(key) ?? null;
     }

package/dist/git-runtime.js

@@ -52,8 +52,10 @@ class GitRuntime {
     try {
       await execFileAsync("git", ["commit", "-m", commitMessage], { cwd: worktreePath });
     } catch (error) {
-      const message = error && typeof error === "object" && "stderr" in error ? String(error.stderr ?? "") : "";
-      if (!message.includes("nothing to commit")) {
+      const stderr = error && typeof error === "object" && "stderr" in error ? String(error.stderr ?? "") : "";
+      const stdout2 = error && typeof error === "object" && "stdout" in error ? String(error.stdout ?? "") : "";
+      if (!`${stdout2}
+${stderr}`.includes("nothing to commit")) {
         throw error;
       }
     }

package/dist/graph/context-query-contracts.d.ts

@@ -0,0 +1,48 @@
+import type { SdkContextPack, SdkContextPackRequest, SdkGraphQueryStage, SdkGraphQueryView } from '../sdk-types.ts';
+export type DeclarativeContextQueryPurpose = 'plan' | 'research' | 'generate' | 'optimize' | 'implement' | 'review' | 'release' | string;
+export type DeclarativeContextQueryFormat = 'summary' | 'full' | 'sources' | 'list' | 'brief' | 'map' | string;
+export interface DeclarativeContextQuery {
+    id: string;
+    purpose: DeclarativeContextQueryPurpose;
+    query: string;
+    scope?: string;
+    relations?: string[];
+    depth?: number;
+    budget?: number;
+    format?: DeclarativeContextQueryFormat;
+    filters?: Record<string, unknown>;
+    required?: boolean;
+}
+export type HandlerContextPackSource = 'agent_spec' | 'content_frontmatter' | 'work_package' | 'task_payload' | 'default_role_context';
+export interface DeclarativeContextQuerySourceRef {
+    source: HandlerContextPackSource;
+    ref?: string;
+    priority: number;
+}
+export interface CompiledDeclarativeContextQuery {
+    query: DeclarativeContextQuery;
+    request: SdkContextPackRequest;
+    warnings: string[];
+}
+export interface DeclarativeContextQueryCompileResult {
+    ok: boolean;
+    compiled: CompiledDeclarativeContextQuery | null;
+    errors: string[];
+    warnings: string[];
+}
+export interface ResolvedHandlerContextPack {
+    id: string;
+    purpose: string;
+    source: HandlerContextPackSource;
+    sourceRef?: string;
+    query: DeclarativeContextQuery;
+    request: SdkContextPackRequest;
+    pack: SdkContextPack;
+    warnings: string[];
+}
+export declare function declarativeContextPurposeToGraphStage(purpose: string): SdkGraphQueryStage;
+export declare function declarativeContextFormatToGraphView(format: string | undefined): SdkGraphQueryView;
+export declare function compileDeclarativeContextQuery(query: DeclarativeContextQuery, options?: {
+    defaultLimit?: number;
+    maxDepth?: number;
+}): DeclarativeContextQueryCompileResult;

package/dist/graph/context-query-contracts.js

@@ -0,0 +1,126 @@
+const VALID_RELATIONS = [
+  "related",
+  "depends_on",
+  "implements",
+  "references",
+  "parent",
+  "child",
+  "supersedes"
+];
+const PURPOSE_TO_STAGE = {
+  plan: "plan",
+  research: "research",
+  implement: "implement",
+  debug: "debug",
+  review: "review"
+};
+const FORMAT_TO_VIEW = {
+  summary: "brief",
+  brief: "brief",
+  full: "full",
+  sources: "list",
+  list: "list",
+  map: "map"
+};
+function asPositiveInteger(value) {
+  return typeof value === "number" && Number.isInteger(value) && value > 0;
+}
+function normalizeString(value) {
+  return value.trim();
+}
+function declarativeContextPurposeToGraphStage(purpose) {
+  return PURPOSE_TO_STAGE[purpose.trim().toLowerCase()] ?? "plan";
+}
+function declarativeContextFormatToGraphView(format) {
+  return FORMAT_TO_VIEW[(format ?? "summary").trim().toLowerCase()] ?? "brief";
+}
+function compileDeclarativeContextQuery(query, options = {}) {
+  const errors = [];
+  const warnings = [];
+  const maxDepth = options.maxDepth ?? 3;
+  const defaultLimit = options.defaultLimit ?? 8;
+  const id = normalizeString(query.id ?? "");
+  if (!id) {
+    errors.push("Context query id is required.");
+  }
+  const purpose = normalizeString(query.purpose ?? "");
+  if (!purpose) {
+    errors.push(`Context query "${id || "<unknown>"}" purpose is required.`);
+  }
+  const textQuery = normalizeString(query.query ?? "");
+  if (!textQuery) {
+    errors.push(`Context query "${id || "<unknown>"}" query is required.`);
+  }
+  const depth = query.depth ?? 1;
+  if (!Number.isInteger(depth) || depth < 0 || depth > maxDepth) {
+    errors.push(`Context query "${id || "<unknown>"}" depth must be an integer between 0 and ${maxDepth}.`);
+  }
+  if (query.budget !== void 0 && !asPositiveInteger(query.budget)) {
+    errors.push(`Context query "${id || "<unknown>"}" budget must be a positive integer.`);
+  }
+  const scope = query.scope === void 0 ? void 0 : normalizeString(query.scope);
+  if (scope !== void 0 && (!scope || !scope.startsWith("/"))) {
+    errors.push(`Context query "${id || "<unknown>"}" scope must start with "/".`);
+  }
+  const relations = (query.relations ?? ["related", "references"]).map((entry) => entry.trim().toLowerCase());
+  const invalidRelations = relations.filter((relation) => !VALID_RELATIONS.includes(relation));
+  if (invalidRelations.length > 0) {
+    errors.push(`Context query "${id || "<unknown>"}" has invalid relations: ${invalidRelations.join(", ")}.`);
+  }
+  const uniqueRelations = [...new Set(relations)];
+  if (uniqueRelations.length !== relations.length) {
+    warnings.push(`Context query "${id || "<unknown>"}" included duplicate relations; duplicates were removed.`);
+  }
+  const stage = declarativeContextPurposeToGraphStage(purpose);
+  if (stage === "plan" && !["plan", ""].includes(purpose.toLowerCase()) && !PURPOSE_TO_STAGE[purpose.toLowerCase()]) {
+    warnings.push(`Context query "${id || "<unknown>"}" purpose "${purpose}" is not a graph stage; using "plan".`);
+  }
+  const view = declarativeContextFormatToGraphView(query.format);
+  if (query.format && !FORMAT_TO_VIEW[query.format.trim().toLowerCase()]) {
+    warnings.push(`Context query "${id || "<unknown>"}" format "${query.format}" is not a graph view; using "brief".`);
+  }
+  if (errors.length > 0) {
+    return { ok: false, compiled: null, errors, warnings };
+  }
+  const request = {
+    query: textQuery,
+    stage,
+    relations: uniqueRelations,
+    view,
+    options: {
+      depth,
+      limit: defaultLimit,
+      maxNodes: defaultLimit
+    }
+  };
+  if (scope) {
+    request.scopePaths = [scope];
+  }
+  if (query.budget !== void 0) {
+    request.budget = {
+      maxTokens: query.budget
+    };
+  }
+  return {
+    ok: true,
+    compiled: {
+      query: {
+        ...query,
+        id,
+        purpose,
+        query: textQuery,
+        scope,
+        relations: uniqueRelations
+      },
+      request,
+      warnings
+    },
+    errors: [],
+    warnings
+  };
+}
+export {
+  compileDeclarativeContextQuery,
+  declarativeContextFormatToGraphView,
+  declarativeContextPurposeToGraphStage
+};

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';
@@ -13,6 +13,7 @@ export { PUBLISHED_CONTENT_MANIFEST_SCHEMA_VERSION, EDITORIAL_PREVIEW_COOKIE, Te
 export { createFilesystemContentSource, createPublishedContentPipeline, } from './platform/published-content-pipeline.ts';
 export { loadTreeseedManifest, loadTreeseedTenantManifest, resolveTreeseedTenantRoot, getTenantContentRoot, tenantFeatureEnabled, tenantModelRendered, } from './platform/tenant-config.ts';
 export { parseGraphDsl } from './graph/dsl.ts';
+export { compileDeclarativeContextQuery, declarativeContextFormatToGraphView, declarativeContextPurposeToGraphStage, type CompiledDeclarativeContextQuery, type DeclarativeContextQuery, type DeclarativeContextQueryCompileResult, type DeclarativeContextQueryFormat, type DeclarativeContextQueryPurpose, type DeclarativeContextQuerySourceRef, type HandlerContextPackSource, type ResolvedHandlerContextPack, } from './graph/context-query-contracts.ts';
 export { createDefaultGraphRankingProvider, DEFAULT_GRAPH_RANKING_PROVIDER } from './graph/ranking.ts';
 export { BUILTIN_MODEL_REGISTRY, MODEL_REGISTRY, buildBuiltinModelRegistry, buildModelRegistry, buildScopedModelRegistry, mergeModelRegistries, resolveModelDefinition, } from './model-registry.ts';
 export { normalizeAgentCliOptions, buildCopilotAllowToolArgs } from './cli-tools.ts';
@@ -20,6 +21,7 @@ export { collectTreeseedDependencyStatus, collectTreeseedToolStatus, createTrees
 export { runTreeseedCopilotTask, type TreeseedCopilotTaskInput, type TreeseedCopilotTaskResult, } from './copilot.ts';
 export { findDispatchCapability, listSdkDispatchCapabilities, listWorkflowDispatchCapabilities, } from './dispatch.ts';
 export { executeSdkOperation, findSdkOperation, listSdkOperationNames, } from './sdk-dispatch.ts';
+export { AGENT_OPERATION_MODES, AGENT_OPERATION_NAMES, createAgentOperationEvent, decideAgentOperationPermission, deniedAgentOperationResult, isAgentOperationName, resolveAgentOperationGrant, type AgentDeterministicOperationStep, type AgentOperationApprovalRef, type AgentOperationEvent, type AgentOperationGrant, type AgentOperationMergeFailure, type AgentOperationMode, type AgentOperationName, type AgentOperationPermissionCode, type AgentOperationPermissionDecision, type AgentOperationRequest, type AgentOperationResult, type AgentOperationStatus, } from './operations/agent-tools.ts';
 export { resolveSdkRecordVersion } from './sdk-version.ts';
 export { normalizeAliasedRecord, preprocessAliasedRecord, resolveAliasedField, } from './field-aliases.ts';
 export { canonicalizeFrontmatter, normalizeFilterFields, normalizeMutationData, normalizeRecordToCanonicalShape, normalizeSortFields, readCanonicalFieldValue, resolveModelField, validateModelFieldAliases, } from './sdk-fields.ts';
@@ -32,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,
@@ -94,6 +124,11 @@ import {
   tenantModelRendered
 } from "./platform/tenant-config.js";
 import { parseGraphDsl } from "./graph/dsl.js";
+import {
+  compileDeclarativeContextQuery,
+  declarativeContextFormatToGraphView,
+  declarativeContextPurposeToGraphStage
+} from "./graph/context-query-contracts.js";
 import { createDefaultGraphRankingProvider, DEFAULT_GRAPH_RANKING_PROVIDER } from "./graph/ranking.js";
 import {
   BUILTIN_MODEL_REGISTRY,
@@ -127,6 +162,15 @@ import {
   findSdkOperation,
   listSdkOperationNames
 } from "./sdk-dispatch.js";
+import {
+  AGENT_OPERATION_MODES,
+  AGENT_OPERATION_NAMES,
+  createAgentOperationEvent,
+  decideAgentOperationPermission,
+  deniedAgentOperationResult,
+  isAgentOperationName,
+  resolveAgentOperationGrant
+} from "./operations/agent-tools.js";
 import { resolveSdkRecordVersion } from "./sdk-version.js";
 import {
   normalizeAliasedRecord,
@@ -200,6 +244,8 @@ import { getTreeseedVerifyDriverStatus, runTreeseedVerifyDriver } from "./verifi
 import { CloudflareHttpD1Database } from "./d1-http.js";
 export {
   AGENT_MESSAGE_KINDS,
+  AGENT_OPERATION_MODES,
+  AGENT_OPERATION_NAMES,
   AgentSdk,
   BUILTIN_MODEL_REGISTRY,
   CloudflareHttpD1Database,
@@ -207,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,
@@ -244,12 +293,16 @@ export {
   buildKnowledgePackMarketPackage,
   buildModelRegistry,
   buildScopedModelRegistry,
+  buildTaskEstimateProfileFromActuals,
   buildTemplateMarketPackage,
   canonicalizeFrontmatter,
   clearMarketSession,
   collectTreeseedDependencyStatus,
   collectTreeseedReconcileStatus,
   collectTreeseedToolStatus,
+  compileDeclarativeContextQuery,
+  computeWorkdayBudgetEnvelope,
+  createAgentOperationEvent,
   createControlPlaneReporter,
   createDefaultGraphRankingProvider,
   createFilesystemContentSource,
@@ -260,12 +313,24 @@ export {
   createTeamScopedR2OverlayContentRuntimeProvider,
   createTreeseedManagedToolEnv,
   createTreeseedReconcileRegistry,
+  decideAgentOperationPermission,
+  decideTaskAdmission,
+  declarativeContextFormatToGraphView,
+  declarativeContextPurposeToGraphStage,
   defaultHubContentResolutionPolicy,
+  deniedAgentOperationResult,
   deriveTreeseedDesiredUnits,
   destroyTreeseedTargetUnits,
   ensureRailwayEnvironment,
   ensureRailwayProject,
   ensureRailwayService,
+  estimateAttentionForTask,
+  estimateConfidenceFromProfile,
+  estimateForClassification,
+  estimateLearningPercentile,
+  estimateLearningVariance,
+  estimateProfileConfidenceScore,
+  estimateUtilityForTask,
   executeKnowledgeHubLaunch,
   executeKnowledgeHubProviderLaunch,
   executeSdkOperation,
@@ -278,6 +343,8 @@ export {
   getTreeseedVerifyDriverStatus,
   importKnowledgePack,
   installTreeseedDependencies,
+  isAgentOperationName,
+  isInterruptedUsageActual,
   isTeamScopedR2ContentEnabled,
   listIntegratedMarketCatalog,
   listRailwayEnvironments,
@@ -292,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,
@@ -310,9 +386,12 @@ export {
   planKnowledgeHubLaunch,
   planKnowledgeHubRepositories,
   planTreeseedReconciliation,
+  predictReserveForCapacityPlan,
   preprocessAliasedRecord,
+  progressivelyAdmitPlanProposal,
   projectConnectionModeFromHosting,
   railwayGraphqlRequest,
+  rankPlannedTaskNodes,
   readCanonicalFieldValue,
   readPublishedContentManifest,
   readPublishedOverlayManifest,
@@ -320,6 +399,7 @@ export {
   removeMarketProfile,
   reservationHasCapacity,
   reserveCreditsForEstimate,
+  resolveAgentOperationGrant,
   resolveAliasedField,
   resolveCatalogMarketProfiles,
   resolveCloudflareR2Bucket,
@@ -347,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/agent-tools.d.ts

@@ -0,0 +1,114 @@
+export declare const AGENT_OPERATION_NAMES: readonly ["switch", "dev", "verify", "save", "stage", "merge_to_staging", "close", "release"];
+export declare const AGENT_OPERATION_MODES: readonly ["dry_run", "read_only", "mutating"];
+export type AgentOperationName = (typeof AGENT_OPERATION_NAMES)[number];
+export type AgentOperationMode = (typeof AGENT_OPERATION_MODES)[number];
+export type AgentOperationStatus = 'completed' | 'waiting' | 'failed' | 'skipped' | 'retry_created';
+export interface AgentOperationApprovalRef {
+    id: string;
+    kind?: string;
+    state: 'pending' | 'approved' | 'rejected' | 'expired' | 'superseded';
+}
+export interface AgentOperationRequest {
+    operation: AgentOperationName;
+    mode: AgentOperationMode;
+    taskId: string;
+    taskKind?: string;
+    workDayId?: string;
+    agentSlug: string;
+    agentRole: string;
+    projectId: string;
+    environment: string;
+    repoRoot: string;
+    worktreeRoot?: string;
+    featureBranch?: string;
+    stagingBranch?: string;
+    approvalId?: string;
+    approval?: AgentOperationApprovalRef;
+    permissionGrantId?: string;
+    allowedPaths?: string[];
+    forbiddenPaths?: string[];
+    changedPaths?: string[];
+    input: Record<string, unknown>;
+}
+export interface AgentDeterministicOperationStep {
+    id: string;
+    operation: AgentOperationName;
+    stage: 'before_mutation' | 'during_mutation' | 'after_mutation' | 'after_verification_passes' | 'after_verification_fails' | 'after_staging_merge_fails' | 'closeout' | string;
+    mode: AgentOperationMode;
+    required?: boolean;
+}
+export interface AgentOperationGrant {
+    id: string;
+    state?: 'active' | 'paused' | 'revoked';
+    operations: AgentOperationName[];
+    modes: AgentOperationMode[];
+    agentRoles?: string[];
+    taskKinds?: string[];
+    projectIds?: string[];
+    environments?: string[];
+    allowedPaths?: string[];
+    forbiddenPaths?: string[];
+    requiresApproval?: boolean;
+    approvalIds?: string[];
+    expiresAt?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface AgentOperationMergeFailure {
+    targetBranch: string;
+    featureBranch: string;
+    conflictedPaths: string[];
+    message: string;
+    repairTaskId?: string;
+}
+export interface AgentOperationResult {
+    operation: AgentOperationName;
+    status: AgentOperationStatus;
+    summary: string;
+    changedPaths: string[];
+    stagedPaths: string[];
+    mergedToStaging?: boolean;
+    mergeFailure?: AgentOperationMergeFailure;
+    commandsRun: string[];
+    artifacts: Array<{
+        kind: string;
+        ref: string;
+    }>;
+    error?: {
+        code: string;
+        message: string;
+        retryable: boolean;
+    };
+    metadata: Record<string, unknown>;
+}
+export type AgentOperationPermissionCode = 'allowed' | 'invalid_operation' | 'operation_permission_required' | 'operation_grant_inactive' | 'operation_grant_expired' | 'operation_mode_not_granted' | 'operation_role_not_granted' | 'operation_task_kind_not_granted' | 'operation_project_not_granted' | 'operation_environment_not_granted' | 'operation_approval_required' | 'operation_release_approval_required' | 'operation_worktree_required' | 'operation_allowed_paths_required' | 'operation_path_not_allowed' | 'operation_path_forbidden';
+export interface AgentOperationPermissionDecision {
+    allowed: boolean;
+    status: 'completed' | 'waiting' | 'failed';
+    code: AgentOperationPermissionCode;
+    summary: string;
+    grant?: AgentOperationGrant;
+    metadata: Record<string, unknown>;
+}
+export interface AgentOperationEvent {
+    operation: AgentOperationName;
+    mode: AgentOperationMode;
+    agentRole: string;
+    taskId: string;
+    permissionGrantId?: string;
+    inputSummary: Record<string, unknown>;
+    result: AgentOperationResult;
+    createdAt: string;
+}
+export declare function isAgentOperationName(value: string): value is AgentOperationName;
+export declare function resolveAgentOperationGrant(request: AgentOperationRequest, grants: readonly AgentOperationGrant[], now?: Date): AgentOperationGrant | null;
+export declare function decideAgentOperationPermission(input: {
+    request: AgentOperationRequest;
+    grants: readonly AgentOperationGrant[];
+    now?: Date;
+}): AgentOperationPermissionDecision;
+export declare function deniedAgentOperationResult(request: AgentOperationRequest, decision: AgentOperationPermissionDecision): AgentOperationResult;
+export declare function createAgentOperationEvent(input: {
+    request: AgentOperationRequest;
+    result: AgentOperationResult;
+    createdAt?: string;
+}): AgentOperationEvent;