@treeseed/sdk 0.12.62 → 0.13.0-rc.10

package/dist/agent-capacity.d.ts

@@ -1,1100 +0,0 @@
-import type { CapacityGrant, CapacityLedgerEntry, CapacityPlan as LegacyCapacityPlan, CapacityProvider, CapacityReservation, ExecutionProvider, TaskUsageActual } from './sdk-types.js';
-import type { TreeseedContentRef } from './content-operations.js';
-import type { AgentRuntimeSpec, AgentWorkPackage, ExecutionCapabilityDemand, ExecutionCapabilitySupply, ExecutionProviderDescriptor, ExecutionResourceNeed } from './types/agents.js';
-export type AgentExecutionMode = 'planning' | 'acting';
-export type AgentPlanningActivityType = 'planning' | 'estimating' | 'reviewing' | 'reporting';
-export type ContentRef = TreeseedContentRef;
-export type AgentEstimateConfidence = 'low' | 'medium' | 'high';
-export type AgentEstimateRiskLevel = 'low' | 'medium' | 'high';
-export type DecisionDependencyType = 'artifact' | 'capability' | 'decision' | 'external-resource' | 'human-input';
-export interface AgentOutputRequirement {
-    id?: string;
-    outputType: string;
-    description?: string;
-    contentModel?: string;
-    required?: boolean;
-    metadata?: Record<string, unknown>;
-}
-export interface DecisionDependencySpec {
-    id: string;
-    type: DecisionDependencyType;
-    requiredBefore: 'start' | 'complete' | 'review' | 'release';
-    optional?: boolean;
-    deliverableType?: string;
-    capability?: string;
-    agentClass?: string;
-    contentRefs?: string[];
-    humanInputPolicy?: {
-        requiredFrom: 'team-human' | 'any-human' | 'any-human-or-agent';
-        teamId?: string | null;
-    };
-    summary?: string;
-}
-export interface StructuredAgentEstimate {
-    id: string;
-    teamId: string;
-    projectId: string;
-    decisionId?: string | null;
-    proposalId?: string | null;
-    workUnitId?: string | null;
-    agentClass: string;
-    agentId?: string | null;
-    minCredits: number;
-    expectedCredits: number;
-    maxCredits: number;
-    confidence: AgentEstimateConfidence;
-    riskLevel: AgentEstimateRiskLevel;
-    assumptions: string[];
-    blockers: string[];
-    dependencies: DecisionDependencySpec[];
-    expectedOutputs: AgentOutputRequirement[];
-    acceptanceCriteria: string[];
-    completionEvidence: string[];
-    createdAt?: string | null;
-    metadata?: Record<string, unknown>;
-}
-export interface DeliverableContract {
-    id: string;
-    teamId: string;
-    projectId: string;
-    decisionId: string;
-    deliverableType: string;
-    producerAgentClasses: string[];
-    reviewerAgentClasses?: string[];
-    requiredSections?: string[];
-    acceptanceCriteria: string[];
-    status: 'required' | 'draft' | 'submitted' | 'approved' | 'rejected';
-    metadata?: Record<string, unknown>;
-}
-export interface DeliverableManifest {
-    id: string;
-    deliverableContractId: string;
-    projectId: string;
-    decisionId: string;
-    producedRefs: ContentRef[];
-    coverage?: Record<string, ContentRef[]>;
-    summary: string;
-    readyForReview: boolean;
-    submittedByAgentId?: string | null;
-    submittedAt?: string | null;
-    metadata?: Record<string, unknown>;
-}
-export interface DecisionAssignmentGraphNode {
-    id: string;
-    decisionId: string;
-    projectId: string;
-    targetAgentClass: string;
-    activityType: AgentPlanningActivityType | 'acting';
-    handler?: string | null;
-    requiredCapabilities: string[];
-    requiredDeliverableContractIds: string[];
-    inputRefs: ContentRef[];
-    outputRequirements: AgentOutputRequirement[];
-    capacity: {
-        expectedCredits: number;
-        maxCredits: number;
-    };
-    status: 'pending' | 'ready' | 'leased' | 'running' | 'blocked' | 'completed' | 'failed' | 'cancelled';
-    metadata?: Record<string, unknown>;
-}
-export interface DecisionAssignmentGraphEdge {
-    fromNodeId: string;
-    toNodeId: string;
-    edgeType: 'blocks-start' | 'blocks-completion' | 'blocks-release';
-    reason?: string;
-}
-export interface DecisionAssignmentGraph {
-    id: string;
-    teamId: string;
-    projectId: string;
-    decisionId: string;
-    version: number;
-    status: 'draft' | 'compiled' | 'ready' | 'executing' | 'completed' | 'blocked';
-    estimateIds: string[];
-    deliverableContracts: DeliverableContract[];
-    nodes: DecisionAssignmentGraphNode[];
-    edges: DecisionAssignmentGraphEdge[];
-    compiledAt?: string | null;
-    compiledBy: 'api-control-plane';
-    metadata?: Record<string, unknown>;
-}
-export interface AgentCapacityContractDiagnostic {
-    severity: 'info' | 'warning' | 'error';
-    code: string;
-    message: string;
-    path?: string;
-}
-export interface AgentCapacityContractValidationResult {
-    ok: boolean;
-    diagnostics: AgentCapacityContractDiagnostic[];
-}
-export interface DecisionAssignmentGraphCompileResult {
-    graph: DecisionAssignmentGraph;
-    diagnostics: AgentCapacityContractDiagnostic[];
-}
-export interface WorkdayModeSplitPolicy {
-    targetPercent: number;
-    minPercent?: number;
-    maxPercent?: number;
-    hardCapPercent?: number;
-}
-export interface WorkdayModeSplits {
-    planning?: WorkdayModeSplitPolicy;
-    acting?: WorkdayModeSplitPolicy;
-}
-export interface PlanningReservationMetadata {
-    source: 'provider_assignment_synthesis' | string;
-    planningSource: 'live_workday' | 'planning_input_request' | 'decision_estimation' | 'decision_review' | 'fallback_planning' | string;
-    activityType: AgentPlanningActivityType;
-    projectAgentClassId?: string | null;
-    agentSlug?: string | null;
-    workdayId?: string | null;
-    allocationSetId?: string | null;
-    modeSplitVersion?: string | null;
-}
-export interface ModeCapacityReservationAvailabilityInput {
-    teamId: string;
-    capacityProviderId: string;
-    projectId: string;
-    workDayId?: string | null;
-    allocationSetId?: string | null;
-    projectAgentClassId?: string | null;
-    agentSlug?: string | null;
-    mode: AgentExecutionMode;
-    activityType?: AgentPlanningActivityType | 'acting' | string | null;
-    reservedCredits: number;
-}
-export interface ModeCapacityReservationAvailabilityResult {
-    ok: boolean;
-    hold?: boolean;
-    reason?: string | null;
-    gates: Record<string, unknown>;
-}
-export declare const DEFAULT_WORKDAY_MODE_SPLITS: Required<WorkdayModeSplits>;
-export type AllocationSetStatus = 'draft' | 'active' | 'superseded' | 'archived';
-export type ProjectAgentClassStatus = 'active' | 'paused' | 'archived';
-export type ProviderAvailabilitySessionStatus = 'open' | 'draining' | 'closed' | 'expired';
-export type ProviderAssignmentStatus = 'pending' | 'leased' | 'running' | 'completed' | 'failed' | 'returned' | 'expired';
-export type ProviderAssignmentLeaseState = 'unleased' | 'leased' | 'released' | 'expired';
-export type AgentModeRunStatus = 'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled';
-export type AgentKernelModeExecutionStatus = 'completed' | 'waiting' | 'failed' | 'returned';
-export type DecisionExecutionReadinessStatus = 'draft' | 'blocked' | 'ready' | 'stale' | 'waived';
-export type PlanningInputRequestStatus = 'requested' | 'complete' | 'waived' | 'rejected' | 'stale';
-export type DecisionExecutionInputStatus = 'proposed' | 'accepted' | 'revision_requested' | 'rejected' | 'stale';
-export type WorkdayCapacityEnvelopeStatus = 'draft' | 'active' | 'paused' | 'completed' | 'cancelled';
-export type DurableAgentCapacityPlanStatus = 'draft' | 'accepted' | 'revision_requested' | 'deferred' | 'scheduled' | 'active' | 'completed' | 'superseded';
-export type ProviderAssignmentSynthesisSource = 'approved_decision' | 'planning_input_request' | 'capacity_plan' | 'verification_failure' | 'fallback_queue' | 'fixture';
-export type AgentKernelModeFallbackCode = 'assignment_missing_project_or_agent' | 'assignment_lease_expired' | 'assignment_mode_not_allowed' | 'assignment_missing_capacity_envelope' | 'assignment_missing_decision_input' | 'assignment_handler_failed' | 'assignment_project_not_synced' | 'assignment_agent_not_found' | 'assignment_insufficient_capability' | 'assignment_decision_not_ready' | 'assignment_capacity_plan_not_accepted' | 'assignment_capacity_not_reserved' | 'assignment_capability_handle_invalid' | 'assignment_capability_handle_secret_material' | 'assignment_capability_handle_write_not_ready' | 'assignment_capability_handle_workspace_denied' | 'assignment_workflow_operation_denied' | 'assignment_eligibility_capability_mismatch' | 'assignment_retry_policy_exceeded' | 'assignment_treedx_proxy_scope_invalid' | 'assignment_fallback_quota_exceeded' | 'assignment_output_invalid';
-export declare const AGENT_ASSIGNMENT_WORKSPACE_ACCESS_MODES: readonly ["context_only", "workspace_write", "brokered_workspace", "full_workspace_no_credentials", "trusted_direct"];
-export type AgentAssignmentWorkspaceAccessMode = (typeof AGENT_ASSIGNMENT_WORKSPACE_ACCESS_MODES)[number];
-export type AgentAssignmentCapabilityHandleKind = 'repository_access' | 'treedx_workspace' | 'workflow_operation' | 'secret_use';
-export type AgentAssignmentCapabilityOperation = 'read' | 'write' | 'test' | 'release' | 'dispatch_workflow' | 'commit' | 'push' | string;
-export interface AllocationSetSlice {
-    projectId: string | null;
-    capacityProviderId: string;
-    laneId?: string | null;
-    environment?: string | null;
-    priorityWeight?: number | null;
-    overflowPolicy?: string | null;
-    percent?: number | null;
-    dailyCreditLimit?: number | null;
-    monthlyCreditLimit?: number | null;
-    metadata?: Record<string, unknown>;
-}
-export interface AllocationSet {
-    id: string;
-    teamId: string;
-    version: string;
-    status: AllocationSetStatus | string;
-    effectiveFrom?: string | null;
-    effectiveUntil?: string | null;
-    policy: Record<string, unknown>;
-    slices: AllocationSetSlice[];
-    createdById?: string | null;
-    activatedAt?: string | null;
-    supersededById?: string | null;
-    metadata?: Record<string, unknown>;
-    createdAt?: string;
-    updatedAt?: string;
-}
-export type CapacityAllocationSet = AllocationSet;
-export interface AgentKernelProfile {
-    id?: string;
-    name?: string;
-    defaultMode?: AgentExecutionMode;
-    allowedModes?: AgentExecutionMode[];
-    planningBudgetPercent?: number;
-    actingBudgetPercent?: number;
-    maxConcurrentModeRuns?: number;
-    fallbackMode?: AgentExecutionMode | null;
-    metadata?: Record<string, unknown>;
-}
-export interface AgentKernelPolicy {
-    modeSelection?: Record<string, unknown>;
-    budgetSplit?: Record<string, unknown>;
-    fallback?: Record<string, unknown>;
-    outputValidation?: Record<string, unknown>;
-    metadata?: Record<string, unknown>;
-}
-export interface ProjectAgentClass {
-    id: string;
-    teamId: string;
-    projectId: string;
-    slug: string;
-    name: string;
-    status: ProjectAgentClassStatus | string;
-    allowedModes: AgentExecutionMode[];
-    requiredCapabilities: string[];
-    kernelProfile: AgentKernelProfile;
-    kernelPolicy: AgentKernelPolicy;
-    handlerRefs: Record<string, unknown>;
-    outputContracts: Record<string, unknown>;
-    metadata?: Record<string, unknown>;
-    createdAt?: string;
-    updatedAt?: string;
-}
-export interface WorkdayCapacityEnvelope {
-    teamId: string;
-    projectId: string;
-    workDayId?: string | null;
-    environment?: string | null;
-    allocationSetId?: string | null;
-    availableCredits?: number | null;
-    reservedCredits?: number | null;
-    consumedCredits?: number | null;
-    metadata?: Record<string, unknown>;
-}
-export interface AgentCapacityEnvelope extends WorkdayCapacityEnvelope {
-    mode: AgentExecutionMode;
-    projectAgentClassId?: string | null;
-    capacityProviderId?: string | null;
-    executionProviderId?: string | null;
-    laneId?: string | null;
-    reservationId?: string | null;
-    nativeUnit?: string | null;
-    reservedNativeAmount?: number | null;
-    limits?: Record<string, unknown>;
-}
-export interface DecisionExecutionInput {
-    teamId: string;
-    projectId: string;
-    projectAgentClassId: string;
-    mode: AgentExecutionMode;
-    taskId?: string | null;
-    workDayId?: string | null;
-    agentId?: string | null;
-    handlerId?: string | null;
-    capacity: AgentCapacityEnvelope;
-    input: Record<string, unknown>;
-    metadata?: Record<string, unknown>;
-}
-export interface AgentCapacityPlan {
-    teamId: string;
-    projectId: string;
-    environment: string;
-    allocationSetId?: string | null;
-    workday: WorkdayCapacityEnvelope;
-    assignableProviders: Array<{
-        capacityProviderId: string;
-        executionProviderId?: string | null;
-        laneId?: string | null;
-        availableCredits?: number | null;
-        reasons?: string[];
-        metadata?: Record<string, unknown>;
-    }>;
-    legacyPlan?: LegacyCapacityPlan | Record<string, unknown> | null;
-    metadata?: Record<string, unknown>;
-}
-export type CapacityPlan = AgentCapacityPlan;
-export interface ProviderAvailabilitySession {
-    id: string;
-    teamId: string;
-    capacityProviderId: string;
-    registrationId?: string | null;
-    environment?: string | null;
-    status: ProviderAvailabilitySessionStatus | string;
-    checkedInAt: string;
-    availableFrom?: string | null;
-    availableUntil?: string | null;
-    executionProviders: ExecutionProvider[];
-    capabilities: string[];
-    grants: CapacityGrant[];
-    nativeLimits?: Record<string, unknown>;
-    runnerPressure?: Record<string, unknown>;
-    constraints?: Record<string, unknown>;
-    metadata?: Record<string, unknown>;
-    createdAt?: string;
-    updatedAt?: string;
-    closedAt?: string | null;
-}
-export interface ProviderAssignment {
-    id: string;
-    teamId: string;
-    projectId: string;
-    capacityProviderId: string;
-    providerSessionId?: string | null;
-    executionProviderId?: string | null;
-    allocationSetId?: string | null;
-    projectAgentClassId: string;
-    reservationId?: string | null;
-    workDayId?: string | null;
-    taskId?: string | null;
-    mode: AgentExecutionMode;
-    status: ProviderAssignmentStatus | string;
-    leaseState: ProviderAssignmentLeaseState | string;
-    leaseExpiresAt?: string | null;
-    leaseToken?: string | null;
-    leaseRenewedAt?: string | null;
-    runnerId?: string | null;
-    agentId?: string | null;
-    handlerId?: string | null;
-    capacityEnvelope: AgentCapacityEnvelope;
-    decisionInput: DecisionExecutionInput | Record<string, unknown>;
-    workspaceContext?: Record<string, unknown>;
-    allowedOutputs?: Record<string, unknown>;
-    explanation?: Record<string, unknown>;
-    attemptCount?: number;
-    assignedAt?: string | null;
-    claimedAt?: string | null;
-    completedAt?: string | null;
-    returnedAt?: string | null;
-    failedAt?: string | null;
-    lifecycleReason?: string | null;
-    lifecycleCode?: string | null;
-    lifecycleOutput?: Record<string, unknown>;
-    synthesizedFrom?: ProviderAssignmentSynthesisSource | string | null;
-    synthesisKey?: string | null;
-    decisionId?: string | null;
-    proposalId?: string | null;
-    fallbackOutputId?: string | null;
-    treedxProxyHandle?: TreeDxProxyHandle | Record<string, unknown> | null;
-    capabilityHandles?: ProviderAssignmentCapabilityHandles | Record<string, unknown> | null;
-    metadata?: Record<string, unknown>;
-    createdAt?: string;
-    updatedAt?: string;
-}
-export interface ProviderAssignmentLifecycleRequest {
-    runnerId?: string | null;
-    leaseToken?: string | null;
-    leaseSeconds?: number | null;
-    reason?: string | null;
-    code?: string | null;
-    message?: string | null;
-    retryable?: boolean | null;
-    output?: Record<string, unknown> | null;
-    summary?: Record<string, unknown> | null;
-    fallbackOutput?: Record<string, unknown> | null;
-    usageActualId?: string | null;
-    modeRunId?: string | null;
-    metadata?: Record<string, unknown>;
-}
-export interface ProviderCheckInRequest {
-    id?: string;
-    registrationId?: string | null;
-    environment?: string | null;
-    status?: ProviderAvailabilitySessionStatus | string;
-    availableFrom?: string | null;
-    availableUntil?: string | null;
-    executionProviders?: ExecutionProvider[];
-    capabilities?: string[];
-    grants?: CapacityGrant[];
-    nativeLimits?: Record<string, unknown>;
-    runnerPressure?: Record<string, unknown>;
-    constraints?: Record<string, unknown>;
-    metadata?: Record<string, unknown>;
-}
-export interface ProviderNextAssignmentRequest {
-    sessionId?: string | null;
-    runnerId?: string | null;
-    leaseSeconds?: number | null;
-    capabilities?: string[];
-    metadata?: Record<string, unknown>;
-}
-export interface ProviderAssignmentLifecycleResult {
-    ok: true;
-    payload: ProviderAssignment | null;
-    assignment?: ProviderAssignment | null;
-    leaseToken?: string | null;
-    leaseSeconds?: number | null;
-    diagnostics?: Record<string, unknown> | null;
-    leaseDiagnostics?: Record<string, unknown> | null;
-}
-export interface AgentModeRunUsageSettlement {
-    taskUsageActualId?: string | null;
-    capacityLedgerEntryId?: string | null;
-    actualCredits?: number | null;
-    actualUsd?: number | null;
-    nativeUsage?: Record<string, unknown> | null;
-    metadata?: Record<string, unknown>;
-}
-export interface AgentModeRun {
-    id: string;
-    teamId: string;
-    projectId: string;
-    providerAssignmentId: string;
-    capacityProviderId: string;
-    executionProviderId?: string | null;
-    projectAgentClassId: string;
-    agentId?: string | null;
-    handlerId?: string | null;
-    mode: AgentExecutionMode;
-    status: AgentModeRunStatus | string;
-    selectedInput: Record<string, unknown>;
-    capacityEnvelope: AgentCapacityEnvelope;
-    outputs?: Record<string, unknown>;
-    traceRefs?: Record<string, unknown>;
-    usageActual?: AgentModeRunUsageSettlement | Record<string, unknown>;
-    validation?: Record<string, unknown>;
-    fallbackReason?: string | null;
-    startedAt?: string | null;
-    completedAt?: string | null;
-    failedAt?: string | null;
-    metadata?: Record<string, unknown>;
-    createdAt?: string;
-    updatedAt?: string;
-}
-export interface AgentKernelModeFallback {
-    code: AgentKernelModeFallbackCode | string;
-    reason: string;
-    retryable: boolean;
-    metadata?: Record<string, unknown>;
-}
-export interface AgentKernelModeExecutionInput {
-    assignment: ProviderAssignment;
-    projectAgentClass?: ProjectAgentClass | null;
-    kernelProfile?: AgentKernelProfile | null;
-    kernelPolicy?: AgentKernelPolicy | null;
-    capacityEnvelope?: AgentCapacityEnvelope | null;
-    decisionInput?: DecisionExecutionInput | null;
-    leaseToken?: string | null;
-    runnerId?: string | null;
-    readiness?: DecisionPlanningStatus | null;
-    treedxProxyHandle?: TreeDxProxyHandle | null;
-    now?: string | Date;
-    metadata?: Record<string, unknown>;
-}
-export interface AgentKernelModeExecutionResult {
-    status: AgentKernelModeExecutionStatus;
-    mode: AgentExecutionMode;
-    assignmentId: string;
-    projectId: string;
-    projectAgentClassId: string;
-    agentId?: string | null;
-    handlerId?: string | null;
-    summary: string;
-    outputs?: Record<string, unknown>;
-    selectedInput: Record<string, unknown>;
-    capacityEnvelope: AgentCapacityEnvelope;
-    traceRefs?: Record<string, unknown>;
-    usageActual?: AgentModeRunUsageSettlement | Record<string, unknown> | null;
-    fallback?: AgentKernelModeFallback | null;
-    metadata?: Record<string, unknown>;
-}
-export interface AgentKernelQueueObservation {
-    planningReady?: number | null;
-    actingReady?: number | null;
-    fallbackReady?: number | null;
-    planningBudgetCredits?: number | null;
-    actingBudgetCredits?: number | null;
-    modePreference?: AgentExecutionMode | 'fallback' | null;
-    metadata?: Record<string, unknown>;
-}
-export interface AgentKernelModeDecision {
-    kind: 'mode' | 'fallback' | 'idle';
-    mode?: AgentExecutionMode | null;
-    reason: string;
-    metadata?: Record<string, unknown>;
-}
-export interface AgentKernelOutputValidationResult {
-    ok: boolean;
-    reason?: string | null;
-    metadata?: Record<string, unknown>;
-}
-export interface DecisionPlanningStatus {
-    id: string;
-    teamId: string;
-    projectId: string;
-    decisionId: string;
-    humanApprovalState?: string | null;
-    executionReadiness: DecisionExecutionReadinessStatus | string;
-    planningInputsStatus: PlanningInputRequestStatus | string;
-    scopeHash: string;
-    staleReason?: string | null;
-    readyAt?: string | null;
-    staleAt?: string | null;
-    metadata?: Record<string, unknown>;
-    createdAt?: string;
-    updatedAt?: string;
-}
-export interface PlanningInputRequest {
-    id: string;
-    teamId: string;
-    projectId: string;
-    decisionId: string;
-    projectAgentClassId?: string | null;
-    mode: AgentExecutionMode;
-    status: PlanningInputRequestStatus | string;
-    scopeHash: string;
-    prompt?: string | null;
-    response?: Record<string, unknown> | null;
-    metadata?: Record<string, unknown>;
-    requestedAt?: string;
-    completedAt?: string | null;
-    staleAt?: string | null;
-}
-export interface DecisionExecutionInputRecord {
-    id: string;
-    teamId: string;
-    projectId: string;
-    decisionId: string;
-    projectAgentClassId: string;
-    mode: AgentExecutionMode;
-    status: DecisionExecutionInputStatus | string;
-    scopeHash: string;
-    input: DecisionExecutionInput;
-    acceptedAt?: string | null;
-    revisionRequestedAt?: string | null;
-    staleAt?: string | null;
-    metadata?: Record<string, unknown>;
-    createdAt?: string;
-    updatedAt?: string;
-}
-export interface WorkdayCapacityEnvelopeRecord {
-    id: string;
-    teamId: string;
-    projectId: string;
-    allocationSetId?: string | null;
-    status: WorkdayCapacityEnvelopeStatus | string;
-    startedAt?: string | null;
-    pausedAt?: string | null;
-    completedAt?: string | null;
-    envelope: WorkdayCapacityEnvelope;
-    modeSplits: Record<string, unknown>;
-    caps: Record<string, unknown>;
-    reserves: Record<string, unknown>;
-    borrowingRules: Record<string, unknown>;
-    metadata?: Record<string, unknown>;
-    createdAt?: string;
-    updatedAt?: string;
-}
-export interface AgentCapacityPlanWorkUnit {
-    id: string;
-    decisionExecutionInputId: string;
-    decisionId: string;
-    projectAgentClassId: string;
-    mode: AgentExecutionMode;
-    taskId?: string | null;
-    agentId?: string | null;
-    handlerId?: string | null;
-    workDayId?: string | null;
-    expectedCredits: number;
-    highCredits: number;
-    requiredCapabilities: string[];
-    dependencies: string[];
-    blockers: string[];
-    risk: Record<string, unknown>;
-    assumptions: string[];
-    confidence?: number | null;
-    capacityEnvelope: AgentCapacityEnvelope;
-    decisionInput: DecisionExecutionInput;
-    metadata?: Record<string, unknown>;
-}
-export interface AgentCapacityPlanRecord {
-    id: string;
-    teamId: string;
-    projectId: string;
-    decisionId: string;
-    status: DurableAgentCapacityPlanStatus | string;
-    scopeHash: string;
-    allocationSetId?: string | null;
-    workDayId?: string | null;
-    expectedCredits: number;
-    highCredits: number;
-    workUnits: AgentCapacityPlanWorkUnit[];
-    capabilityNeeds: string[];
-    environmentNeeds: string[];
-    reserves: Record<string, unknown>;
-    blockers: string[];
-    priorityRationale?: string | null;
-    review?: Record<string, unknown>;
-    metadata?: Record<string, unknown>;
-    acceptedAt?: string | null;
-    scheduledAt?: string | null;
-    supersededAt?: string | null;
-    createdAt?: string;
-    updatedAt?: string;
-}
-export interface ProviderAssignmentSynthesisCandidate {
-    id?: string;
-    teamId: string;
-    projectId: string;
-    capacityProviderId: string;
-    executionProviderId?: string | null;
-    projectAgentClassId: string;
-    mode: AgentExecutionMode;
-    source: ProviderAssignmentSynthesisSource | string;
-    sourceId: string;
-    synthesisKey: string;
-    priority?: number | null;
-    readiness?: DecisionPlanningStatus | null;
-    capacityEnvelope: AgentCapacityEnvelope;
-    decisionInput: DecisionExecutionInput;
-    workspaceContext?: Record<string, unknown>;
-    explanation?: ProviderAssignmentExplanation | Record<string, unknown>;
-    metadata?: Record<string, unknown>;
-}
-export interface ProviderAssignmentExplanation {
-    id?: string;
-    teamId: string;
-    assignmentId: string;
-    source: ProviderAssignmentSynthesisSource | string;
-    sourceId?: string | null;
-    eligible: boolean;
-    reasons: string[];
-    gates: Record<string, unknown>;
-    allocationPolicyVersion?: string | null;
-    grantScope?: string | null;
-    createdAt?: string;
-    metadata?: Record<string, unknown>;
-}
-export interface ExecutionCapabilityGateInput {
-    grantMatches?: boolean;
-    availabilityMatches?: boolean;
-    runnerPressureAllows?: boolean;
-    budgetAllows?: boolean;
-    readinessAllows?: boolean;
-    capabilityHandlesCanBeIssued?: boolean;
-    metadata?: Record<string, unknown>;
-}
-export interface ExecutionProviderEligibilityResult {
-    eligible: boolean;
-    requiredCapabilities: string[];
-    preferredCapabilities: string[];
-    availableCapabilities: string[];
-    aliasCapabilities: string[];
-    missingCapabilities: string[];
-    reasonCodes: string[];
-    gates: {
-        grantMatches: boolean;
-        availabilityMatches: boolean;
-        runnerPressureAllows: boolean;
-        budgetAllows: boolean;
-        readinessAllows: boolean;
-        capabilityHandlesCanBeIssued: boolean;
-    };
-    metadata?: Record<string, unknown>;
-}
-export interface BuildExecutionProviderAssignmentExplanationInput {
-    source: ProviderAssignmentSynthesisSource | string;
-    sourceId?: string | null;
-    demand: ExecutionCapabilityDemand;
-    supply: ExecutionCapabilitySupply;
-    eligibility: ExecutionProviderEligibilityResult;
-    allocationPolicyVersion?: string | null;
-    grantId?: string | null;
-    grantScope?: string | null;
-    readinessGate?: Record<string, unknown> | null;
-    allocationBudgetGate?: Record<string, unknown> | null;
-    capabilityHandleGate?: Record<string, unknown> | null;
-    metadata?: Record<string, unknown>;
-}
-export interface ExecutionProviderVisibilitySummary {
-    executionProviderId: string | null;
-    executionProviderKind: string | null;
-    adapterStatus: string | null;
-    externalRef: string | null;
-    externalUrl: string | null;
-    blockerReason: string | null;
-    usage: unknown[];
-    artifacts: unknown[];
-    requiredCapabilities: string[];
-    preferredCapabilities: string[];
-    availableCapabilities: string[];
-    aliasCapabilities: string[];
-    missingCapabilities: string[];
-    selectedProvider: string | null;
-    selectedExecutionProvider: string | null;
-    capabilityEligible: boolean | null;
-    reasonCodes: string[];
-    metadata: Record<string, unknown>;
-}
-export type CapacityRuntimeBlockerOwner = 'project' | 'team_admin' | 'provider_operator' | 'system';
-export type CapacityRuntimeBlockerSeverity = 'info' | 'warning' | 'danger';
-export interface CapacityRuntimeBlockerVm {
-    code: string;
-    severity: CapacityRuntimeBlockerSeverity;
-    title: string;
-    message: string;
-    owner: CapacityRuntimeBlockerOwner;
-    assignmentId?: string | null;
-    projectId?: string | null;
-    providerId?: string | null;
-    nextAction: string;
-    evidence: Array<{
-        label: string;
-        value: string;
-    }>;
-}
-export interface CapacityRuntimeDiagnosticsResponse {
-    projectId: string;
-    teamId: string;
-    generatedAt: string;
-    assignments: ProviderAssignment[];
-    explanations: ProviderAssignmentExplanation[];
-    modeRuns: AgentModeRun[];
-    treeDxProxyAudit: Array<Record<string, unknown>>;
-    ledgerEntries: Array<CapacityLedgerEntry & {
-        assignmentId?: string | null;
-        modeRunId?: string | null;
-    }>;
-    fallbackOutputs: Array<Record<string, unknown>>;
-    diagnostics: CapacityRuntimeBlockerVm[];
-}
-export interface CapacitySettlementInvariantViolation {
-    code: string;
-    message: string;
-    severity: 'warning' | 'error';
-}
-export interface CapacitySettlementInvariantResult {
-    ok: boolean;
-    status: 'pass' | 'warning' | 'fail';
-    violations: CapacitySettlementInvariantViolation[];
-}
-export interface TreeDxProxyHandle {
-    id: string;
-    teamId: string;
-    projectId: string;
-    assignmentId?: string | null;
-    repositoryId?: string | null;
-    workspaceId?: string | null;
-    status?: 'issued' | 'active' | 'revoked' | 'expired' | string;
-    scopes: string[];
-    expiresAt?: string | null;
-    issuedAt?: string | null;
-    revokedAt?: string | null;
-    auditId?: string | null;
-    token?: string | null;
-    tokenHash?: string | null;
-    allowedOperations?: string[];
-    allowedPaths?: string[];
-    metadata?: Record<string, unknown>;
-}
-export interface ProviderAssignmentCapabilityHandleBase {
-    id: string;
-    kind: AgentAssignmentCapabilityHandleKind;
-    teamId: string;
-    projectId: string;
-    assignmentId: string;
-    status?: 'active' | 'issued' | 'revoked' | 'expired' | 'blocked' | string;
-    workspaceAccessMode?: AgentAssignmentWorkspaceAccessMode | string | null;
-    operations?: AgentAssignmentCapabilityOperation[];
-    expiresAt?: string | null;
-    issuedAt?: string | null;
-    metadata?: Record<string, unknown>;
-}
-export interface ProviderRepositoryAccessHandle extends ProviderAssignmentCapabilityHandleBase {
-    kind: 'repository_access';
-    repositoryId?: string | null;
-    repository?: string | null;
-    provider?: 'github_app' | 'treedx_proxy' | 'local_workspace' | 'workflow_operation' | string;
-    allowedRefs?: string[];
-    allowedPaths?: string[];
-    credentialMode?: 'none' | 'brokered' | 'ephemeral_trusted_direct' | string;
-}
-export interface ProviderTreeDxWorkspaceHandle extends ProviderAssignmentCapabilityHandleBase {
-    kind: 'treedx_workspace';
-    proxyHandleId: string;
-    repositoryId?: string | null;
-    workspaceId?: string | null;
-    allowedOperations?: string[];
-    allowedPaths?: string[];
-}
-export interface ProviderWorkflowOperationHandle extends ProviderAssignmentCapabilityHandleBase {
-    kind: 'workflow_operation';
-    operationId: string;
-    repository: string;
-    workflowFile: string;
-    ref?: string | null;
-    environment?: string | null;
-    secretBearing?: boolean;
-    trustedExecutionSetId?: string | null;
-    allowedInputs?: Record<string, unknown>;
-}
-export interface ProviderSecretUseHandle extends ProviderAssignmentCapabilityHandleBase {
-    kind: 'secret_use';
-    secretIds?: string[];
-    secretClasses?: string[];
-    custodyMode?: string | null;
-    revealAllowed?: false;
-}
-export type ProviderAssignmentCapabilityHandle = ProviderRepositoryAccessHandle | ProviderTreeDxWorkspaceHandle | ProviderWorkflowOperationHandle | ProviderSecretUseHandle;
-export interface ProviderAssignmentCapabilityHandles {
-    workspaceAccessMode: AgentAssignmentWorkspaceAccessMode;
-    repository?: ProviderRepositoryAccessHandle[];
-    treeDx?: ProviderTreeDxWorkspaceHandle[];
-    workflowOperations?: ProviderWorkflowOperationHandle[];
-    secrets?: ProviderSecretUseHandle[];
-    metadata?: Record<string, unknown>;
-}
-export interface TreeDxProxyAccessRequest {
-    teamId?: string | null;
-    projectId: string;
-    assignmentId?: string | null;
-    repositoryId?: string | null;
-    workspaceId?: string | null;
-    operation?: string | null;
-    path?: string | null;
-    token?: string | null;
-    now?: Date;
-}
-export interface TreeDxProxyAccessResult {
-    ok: boolean;
-    code?: string;
-    reason?: string;
-    metadata?: Record<string, unknown>;
-}
-export interface TreeDxProjectProxyAuditRecord {
-    id: string;
-    teamId: string;
-    projectId: string;
-    assignmentId?: string | null;
-    actorType: 'user' | 'capacity_provider' | string;
-    actorId?: string | null;
-    method: string;
-    path: string;
-    handle?: TreeDxProxyHandle | Record<string, unknown> | null;
-    resultStatus: string;
-    metadata?: Record<string, unknown>;
-    createdAt?: string;
-}
-export interface AgentFallbackOutput {
-    id: string;
-    teamId: string;
-    projectId: string;
-    assignmentId?: string | null;
-    mode: AgentExecutionMode;
-    code: AgentKernelModeFallbackCode | string;
-    status: 'draft' | 'emitted' | 'suppressed' | 'duplicate' | 'quota_exceeded' | string;
-    output: Record<string, unknown>;
-    provenance: Record<string, unknown>;
-    quota: Record<string, unknown>;
-    metadata?: Record<string, unknown>;
-    createdAt?: string;
-}
-export interface CapacitySettlementSummary {
-    id?: string;
-    teamId: string;
-    projectId?: string | null;
-    workDayId?: string | null;
-    allocationSetId?: string | null;
-    policyVersion?: string | null;
-    reservedCredits: number;
-    consumedCredits: number;
-    releasedCredits: number;
-    refundedCredits: number;
-    nativeUsage: Record<string, unknown>;
-    providerConfidence: 'high' | 'medium' | 'low' | 'blocked' | string;
-    warnings: string[];
-    metadata?: Record<string, unknown>;
-    createdAt?: string;
-}
-export declare function validateDecisionDependencySpec(dependency: DecisionDependencySpec, path?: string): AgentCapacityContractValidationResult;
-export declare function validateStructuredAgentEstimate(estimate: StructuredAgentEstimate): AgentCapacityContractValidationResult;
-export declare function validateDeliverableContract(contract: DeliverableContract): AgentCapacityContractValidationResult;
-export declare function validateDeliverableManifest(manifest: DeliverableManifest): AgentCapacityContractValidationResult;
-export declare function validateDecisionAssignmentGraph(graph: DecisionAssignmentGraph): AgentCapacityContractValidationResult;
-export declare function compileDecisionAssignmentGraphFromEstimates(input: {
-    id?: string;
-    teamId: string;
-    projectId: string;
-    decisionId: string;
-    version?: number;
-    estimates: StructuredAgentEstimate[];
-    compiledAt?: string | null;
-}): DecisionAssignmentGraphCompileResult;
-export declare function computeDecisionScopeHash(scope: unknown): string;
-export declare function isDecisionReadyForActing(status?: Pick<DecisionPlanningStatus, 'executionReadiness' | 'planningInputsStatus'> | null): boolean;
-export declare function isPlanningInputOpen(request: Pick<PlanningInputRequest, 'status'>): boolean;
-export declare function isDecisionExecutionInputAccepted(input: Pick<DecisionExecutionInputRecord, 'status'>): boolean;
-export declare function isAgentCapacityPlanAccepted(plan?: Pick<AgentCapacityPlanRecord, 'status'> | null): boolean;
-export declare function normalizeDecisionExecutionEstimate(input: DecisionExecutionInputRecord | DecisionExecutionInput): {
-    expectedCredits: number;
-    highCredits: number;
-    requiredCapabilities: string[];
-    dependencies: string[];
-    blockers: string[];
-    assumptions: string[];
-    confidence: number | null;
-    environmentNeeds: string[];
-    risk: Record<string, unknown>;
-};
-export declare function buildAgentCapacityPlanDraft(input: {
-    id: string;
-    teamId: string;
-    projectId: string;
-    decisionId: string;
-    scopeHash: string;
-    executionInputs: DecisionExecutionInputRecord[];
-    allocationSetId?: string | null;
-    workDayId?: string | null;
-    status?: DurableAgentCapacityPlanStatus | string;
-    metadata?: Record<string, unknown>;
-    now?: string;
-}): AgentCapacityPlanRecord;
-export declare function isProviderAssignmentCandidateEligible(candidate: ProviderAssignmentSynthesisCandidate): boolean;
-export declare function validateTreeDxProxyHandle(handle: TreeDxProxyHandle | null | undefined, expected: {
-    teamId?: string | null;
-    projectId: string;
-    assignmentId?: string | null;
-}): AgentKernelModeFallback | null;
-export declare function redactedProviderAssignmentCapabilityHandles(handles: ProviderAssignmentCapabilityHandles | Record<string, unknown> | null | undefined): ProviderAssignmentCapabilityHandles;
-export declare function providerAssignmentCapabilityHandlesContainSecretMaterial(value: unknown): boolean;
-export declare function validateProviderAssignmentCapabilityHandles(input: {
-    assignment: Pick<ProviderAssignment, 'id' | 'teamId' | 'projectId' | 'mode' | 'metadata' | 'decisionInput' | 'capacityEnvelope' | 'synthesizedFrom'> & {
-        capabilityHandles?: ProviderAssignmentCapabilityHandles | Record<string, unknown> | null;
-    };
-    capabilityHandles?: ProviderAssignmentCapabilityHandles | Record<string, unknown> | null;
-    decisionInput?: DecisionExecutionInput | null;
-    capacityEnvelope?: AgentCapacityEnvelope | null;
-    now?: Date;
-}): AgentKernelModeFallback | null;
-export declare function evaluateTreeDxProxyHandleAccess(handle: TreeDxProxyHandle | null | undefined, request: TreeDxProxyAccessRequest): TreeDxProxyAccessResult;
-export declare function compileExecutionCapabilityDemand(input: {
-    agent?: Pick<AgentRuntimeSpec, 'execution' | 'outputs'> | null;
-    projectAgentClass?: Pick<ProjectAgentClass, 'requiredCapabilities'> | null;
-    decisionInput?: DecisionExecutionInput | Record<string, unknown> | null;
-    capacityEnvelope?: AgentCapacityEnvelope | Record<string, unknown> | null;
-    workUnit?: Pick<AgentCapacityPlanWorkUnit, 'requiredCapabilities' | 'metadata'> | null;
-    assignment?: Pick<ProviderAssignment, 'mode' | 'metadata' | 'workspaceContext' | 'capabilityHandles' | 'allowedOutputs'> | null;
-    workPackage?: AgentWorkPackage | null;
-    mode?: AgentExecutionMode | string | null;
-    resourceNeeds?: ExecutionResourceNeed[];
-    metadata?: Record<string, unknown>;
-}): ExecutionCapabilityDemand;
-export declare function compileExecutionCapabilitySupply(input: {
-    capacityProviderId: string;
-    executionProviderId?: string | null;
-    kind?: string | null;
-    descriptor?: ExecutionProviderDescriptor | null;
-    executionProvider?: ExecutionProvider | null;
-    availabilitySession?: ProviderAvailabilitySession | null;
-    providerCapabilities?: string[] | unknown[] | null;
-    checkInCapabilities?: string[] | unknown[] | null;
-    grants?: CapacityGrant[];
-    pressure?: ExecutionCapabilitySupply['pressure'];
-    maxConcurrentAssignments?: number | null;
-    metadata?: Record<string, unknown>;
-}): ExecutionCapabilitySupply;
-export declare function evaluateExecutionProviderEligibility(input: {
-    demand: ExecutionCapabilityDemand;
-    supply: ExecutionCapabilitySupply;
-    gates?: ExecutionCapabilityGateInput;
-}): ExecutionProviderEligibilityResult;
-export declare function buildProviderAssignmentExplanation(input: {
-    source: ProviderAssignmentSynthesisSource | string;
-    sourceId?: string | null;
-    eligible: boolean;
-    reasons?: string[];
-    gates?: Record<string, unknown>;
-    allocationPolicyVersion?: string | null;
-    grantScope?: string | null;
-    metadata?: Record<string, unknown>;
-}): ProviderAssignmentExplanation;
-export declare function buildExecutionProviderAssignmentExplanation(input: BuildExecutionProviderAssignmentExplanationInput): ProviderAssignmentExplanation;
-export declare function summarizeExecutionProviderVisibility(input: {
-    assignment?: Record<string, unknown> | null;
-    modeRun?: Record<string, unknown> | null;
-    explanation?: Record<string, unknown> | null;
-}): ExecutionProviderVisibilitySummary;
-export declare function decorateExecutionProviderVisibility<T extends Record<string, unknown>>(recordInput: T, options?: {
-    explanation?: Record<string, unknown> | null;
-    modeRun?: Record<string, unknown> | null;
-}): T & {
-    executionVisibility: ExecutionProviderVisibilitySummary;
-};
-export declare function evaluateFallbackQuota(input: {
-    existingCount?: number | null;
-    quota?: number | null;
-}): AgentKernelModeFallback | null;
-export declare function deriveAllocationSetFromCapacityGrants(input: {
-    id: string;
-    teamId: string;
-    version?: string;
-    status?: AllocationSetStatus | string;
-    grants: CapacityGrant[];
-    createdById?: string | null;
-    now?: string;
-    metadata?: Record<string, unknown>;
-}): AllocationSet;
-export declare function deriveProviderAvailabilitySession(input: {
-    id: string;
-    provider: CapacityProvider;
-    registrationId?: string | null;
-    environment?: string | null;
-    executionProviders?: ExecutionProvider[];
-    grants?: CapacityGrant[];
-    runnerPressure?: Record<string, unknown>;
-    constraints?: Record<string, unknown>;
-    now?: string;
-    metadata?: Record<string, unknown>;
-}): ProviderAvailabilitySession;
-export declare function deriveAgentCapacityPlanFromCapacityPlan(plan: LegacyCapacityPlan | Record<string, unknown>): AgentCapacityPlan;
-export declare function deriveAgentCapacityEnvelopeFromReservation(input: {
-    reservation: CapacityReservation;
-    mode: AgentExecutionMode;
-    projectAgentClassId?: string | null;
-    allocationSetId?: string | null;
-    environment?: string | null;
-    limits?: Record<string, unknown>;
-    metadata?: Record<string, unknown>;
-}): AgentCapacityEnvelope;
-export declare function deriveModeRunUsageSettlement(actual: TaskUsageActual): AgentModeRunUsageSettlement;
-export declare function isAgentExecutionMode(value: unknown): value is AgentExecutionMode;
-export declare function normalizeAgentExecutionMode(value: unknown, fallback?: AgentExecutionMode): AgentExecutionMode;
-export declare function createAgentKernelModeFallback(code: AgentKernelModeFallbackCode | string, reason: string, options?: {
-    retryable?: boolean;
-    metadata?: Record<string, unknown>;
-}): AgentKernelModeFallback;
-export declare function isAgentModeAllowedForClass(mode: AgentExecutionMode, agentClass?: Pick<ProjectAgentClass, 'allowedModes' | 'status'> | null, profile?: Pick<AgentKernelProfile, 'allowedModes'> | null): boolean;
-export declare function deriveAgentCapacityEnvelopeFromAssignment(assignment: Pick<ProviderAssignment, 'teamId' | 'projectId' | 'mode' | 'capacityProviderId' | 'executionProviderId' | 'allocationSetId' | 'projectAgentClassId' | 'reservationId' | 'workDayId' | 'capacityEnvelope'>): AgentCapacityEnvelope;
-export declare function deriveDecisionExecutionInputFromAssignment(assignment: Pick<ProviderAssignment, 'teamId' | 'projectId' | 'projectAgentClassId' | 'mode' | 'taskId' | 'workDayId' | 'agentId' | 'handlerId' | 'decisionInput' | 'capacityEnvelope'>): DecisionExecutionInput;
-export declare function validateAgentKernelModeExecutionInput(input: AgentKernelModeExecutionInput): AgentKernelModeFallback | null;
-export declare function selectAgentKernelModeDecision(observation: AgentKernelQueueObservation): AgentKernelModeDecision;
-export declare function validateAgentKernelOutputs(input: {
-    mode: AgentExecutionMode;
-    outputs?: Record<string, unknown> | null;
-    allowedOutputs?: Record<string, unknown> | null;
-}): AgentKernelOutputValidationResult;
-export declare function treeDxProxyHeaders(handle: TreeDxProxyHandle): Record<string, string>;
-export declare function isAgentCapacityPlanStaleOrSuperseded(plan: Pick<AgentCapacityPlanRecord, 'status'> & {
-    scopeHash?: string | null;
-}, currentScopeHash?: string | null): boolean;
-export declare function hasAcceptedCapacityPlanProvenance(input: {
-    assignment?: Pick<ProviderAssignment, 'metadata' | 'decisionInput' | 'capacityEnvelope' | 'synthesizedFrom'> | null;
-    decisionInput?: DecisionExecutionInput | null;
-    capacityEnvelope?: AgentCapacityEnvelope | null;
-}): boolean;
-export declare function isProviderAssignmentLeaseExpired(assignment: Pick<ProviderAssignment, 'leaseExpiresAt'>, now?: Date): boolean;
-export declare function isProviderAssignmentLeasable(assignment: Pick<ProviderAssignment, 'status' | 'leaseState' | 'leaseExpiresAt'>, now?: Date): boolean;
-export declare function summarizeCapacityRuntimeDiagnostics(input: {
-    projectId: string;
-    teamId: string;
-    generatedAt?: string;
-    assignments: ProviderAssignment[];
-    explanations?: ProviderAssignmentExplanation[];
-    modeRuns?: AgentModeRun[];
-    treeDxProxyAudit?: Array<Record<string, unknown>>;
-    ledgerEntries?: Array<CapacityLedgerEntry & {
-        assignmentId?: string | null;
-        modeRunId?: string | null;
-    }>;
-    fallbackOutputs?: Array<Record<string, unknown>>;
-}): CapacityRuntimeDiagnosticsResponse;
-export declare function validateCapacitySettlementInvariant(input: {
-    assignment: ProviderAssignment;
-    reservation?: CapacityReservation | null;
-    ledgerEntries: Array<CapacityLedgerEntry & {
-        assignmentId?: string | null;
-        modeRunId?: string | null;
-    }>;
-}): CapacitySettlementInvariantResult;