@treeseed/sdk 0.12.62 → 0.13.0-rc.10

package/dist/capacity-provider.d.ts

@@ -1,494 +0,0 @@
-import type { CapacityGrant, NativeUsageObservation } from './sdk-types.js';
-import type { ProjectRepositoryTopology } from './sdk-types.js';
-import type { SeedProjectArchitecture } from './seeds/types.js';
-import type { ProviderAssignmentLifecycleRequest, ProviderAssignmentLifecycleResult, ProviderCheckInRequest, ProviderNextAssignmentRequest } from './agent-capacity.js';
-export declare const CAPACITY_PROVIDER_ENDPOINTS: {
-    readonly register: "/v1/provider/register";
-    readonly heartbeat: "/v1/provider/heartbeat";
-    readonly checkIn: "/v1/provider/check-in";
-    readonly sessions: "/v1/provider/sessions";
-    readonly portfolio: "/v1/provider/portfolio";
-    readonly workdays: "/v1/provider/workdays";
-    readonly nextAssignment: "/v1/provider/assignments/next";
-    readonly assignment: (assignmentId: string) => string;
-    readonly assignmentRenew: (assignmentId: string) => string;
-    readonly assignmentReturn: (assignmentId: string) => string;
-    readonly assignmentComplete: (assignmentId: string) => string;
-    readonly assignmentFail: (assignmentId: string) => string;
-    readonly assignmentModeRuns: (assignmentId: string) => string;
-    readonly assignmentWorkflowOperationDispatch: (assignmentId: string, operationId: string) => string;
-    readonly assignmentExplanation: (assignmentId: string) => string;
-    readonly usage: "/v1/provider/usage";
-    readonly reports: "/v1/provider/reports";
-};
-export declare const CAPACITY_PROVIDER_SCOPES: readonly ["provider:register", "provider:heartbeat", "provider:portfolio:read", "provider:assignments:read", "provider:assignments:write", "provider:usage:report", "provider:reports:write", "provider:capabilities:write"];
-export declare const CAPACITY_PROVIDER_ENV_KEYS: readonly ["TREESEED_MANAGEMENT_API_URL", "TREESEED_MARKET_URL", "TREESEED_MARKET_ID", "TREESEED_MANAGER_ID", "TREESEED_CAPACITY_PROVIDER_ID", "TREESEED_CAPACITY_PROVIDER_TEAM_ID", "TREESEED_CAPACITY_PROVIDER_API_KEY", "TREESEED_PROVIDER_HOST_DATA_DIR", "TREESEED_HOST_CODEX_AUTH_FILE", "TREESEED_PROVIDER_DATA_DIR", "TREESEED_PROVIDER_ENVIRONMENT", "TREESEED_PROVIDER_CAPABILITIES_FILE", "TREESEED_PROVIDER_BUDGET_FILE", "TREESEED_PROVIDER_MAX_CONCURRENT_WORKDAYS", "TREESEED_PROVIDER_MAX_CONCURRENT_RUNNERS", "TREESEED_PROVIDER_DAILY_CREDIT_BUDGET", "TREESEED_PROVIDER_MONTHLY_CREDIT_BUDGET", "TREESEED_PROVIDER_STARTUP_MODE", "TREESEED_CODEX_AUTH_FILE", "TREESEED_CODEX_AUTH_JSON_B64", "TREESEED_CODEX_AUTH_OVERWRITE", "TREESEED_TREEDX_BASE_URL", "TREESEED_TREEDX_URL", "TREESEED_TREEDX_TOKEN", "TREESEED_TREEDX_REPO_ID", "TREESEED_TREEDX_REF", "TREESEED_TREEDX_WORKSPACE_ID", "TREESEED_TREEDX_JWT_ISSUER", "TREESEED_TREEDX_JWT_AUDIENCE", "TREESEED_TREEDX_JWT_HS256_SECRET", "TREESEED_TREEDX_PROXY_ACTOR_ID", "TREESEED_TREEDX_PROXY_TENANT_ID"];
-export type CapacityProviderScope = (typeof CAPACITY_PROVIDER_SCOPES)[number];
-export type CapacityProviderEnvironmentName = 'local' | 'staging' | 'prod' | 'production' | string;
-export type CapacityProviderLaunchMode = 'self_hosted' | 'managed_market_host' | 'connected_host';
-export type CapacityProviderStatus = 'pending' | 'online' | 'offline' | 'disabled' | 'rotation_required' | string;
-export type CapacityProviderConnectionState = 'waiting_for_provider' | 'connected' | 'auth_failed' | 'stale' | 'disabled' | string;
-export type CapacityProviderDeploymentStatus = 'not_deployed' | 'deploying' | 'deployed' | 'failed' | string;
-export type CapacityProviderDeploymentServiceRole = 'api' | 'manager' | 'runner';
-export declare const CAPACITY_PROVIDER_DEPLOYMENT_SERVICE_ROLES: readonly ["api", "manager", "runner"];
-export declare const DEFAULT_CAPACITY_PROVIDER_ROLE_IMAGES: {
-    readonly api: "treeseed/agent-provider-api";
-    readonly manager: "treeseed/agent-manager";
-    readonly runner: "treeseed/agent-runner";
-};
-export interface CapacityProviderRuntimeInfo {
-    package: '@treeseed/agent' | string;
-    version: string;
-    entrypoint: string;
-    roles: string[];
-}
-export interface CapacityProviderCapability {
-    id: string;
-    agents: string[];
-    operations: string[];
-    models: string[];
-    repositoryAccess: string;
-    verification: string[];
-    metadata?: Record<string, unknown>;
-}
-export type NativeCapacityUnit = 'wall_minute' | 'quota_minute' | 'usd' | 'token' | 'request' | 'gpu_second' | 'human_minute' | 'custom' | string;
-export type NativeCapacityLimitScope = 'daily' | 'weekly' | 'monthly' | 'session' | 'rolling_window' | string;
-export type NativeCapacityConfidence = 'exact' | 'estimated' | 'opaque' | string;
-export type NativeCapacityLimitSource = 'configured' | 'observed' | 'learned' | 'manual_override' | string;
-export type ProviderQuotaVisibility = 'exact' | 'partial' | 'opaque' | string;
-export interface ExecutionProviderNativeLimitCapacity {
-    id?: string;
-    scope?: NativeCapacityLimitScope;
-    limitScope?: NativeCapacityLimitScope;
-    nativeUnit?: NativeCapacityUnit;
-    limitAmount: number;
-    reserveBufferPercent?: number | null;
-    resetCadence?: string | null;
-    resetAt?: string | null;
-    confidence?: NativeCapacityConfidence;
-    source?: NativeCapacityLimitSource;
-    metadata?: Record<string, unknown>;
-}
-export interface ExecutionProviderObservationCapacity {
-    id?: string;
-    observedAt?: string;
-    health?: string;
-    activeWorkers?: number | null;
-    queuedTasks?: number | null;
-    throttleState?: string | null;
-    nativeRemaining?: Record<string, unknown>;
-    resetAt?: string | null;
-    confidence?: NativeCapacityConfidence;
-    metadata?: Record<string, unknown>;
-}
-export interface ExecutionProviderNativeCapacity {
-    id?: string;
-    name: string;
-    kind: string;
-    status?: string;
-    nativeUnit: NativeCapacityUnit;
-    quotaVisibility?: ProviderQuotaVisibility;
-    maxConcurrentWorkers?: number | null;
-    resetCadence?: string | null;
-    config?: Record<string, unknown>;
-    metadata?: Record<string, unknown>;
-    nativeLimits?: ExecutionProviderNativeLimitCapacity[];
-    observation?: ExecutionProviderObservationCapacity;
-}
-export interface CapacityProviderNativeCapacity {
-    executionProviders: ExecutionProviderNativeCapacity[];
-}
-export interface CapacityProviderBudgetCapacity {
-    dailyCreditBudget?: number | null;
-    monthlyCreditBudget?: number | null;
-    maxConcurrentWorkdays?: number | null;
-    maxConcurrentRunners?: number | null;
-    nativeCapacity?: CapacityProviderNativeCapacity;
-    [key: string]: unknown;
-}
-export interface CapacityProviderHealthState {
-    dataDirWritable?: boolean;
-    codexReady?: boolean;
-    [key: string]: unknown;
-}
-export interface CapacityProviderRegistrationRequest {
-    marketId?: string;
-    runtime: CapacityProviderRuntimeInfo;
-    capabilities: CapacityProviderCapability[];
-    budgets: CapacityProviderBudgetCapacity;
-    health: CapacityProviderHealthState;
-}
-export interface CapacityProviderRegistrationResponse {
-    ok: true;
-    provider: {
-        id: string;
-        teamId: string;
-        name: string;
-        status: CapacityProviderStatus;
-        connectionState?: CapacityProviderConnectionState;
-    };
-    portfolioManifestUrl: string;
-    heartbeatIntervalSeconds: number;
-    sessionToken?: string | null;
-    sessionExpiresAt?: string | null;
-}
-export interface CapacityProviderHeartbeatRequest {
-    marketId?: string;
-    providerId?: string | null;
-    runtime?: CapacityProviderRuntimeInfo;
-    capabilities?: CapacityProviderCapability[];
-    budgets?: CapacityProviderBudgetCapacity;
-    health?: CapacityProviderHealthState;
-    status?: CapacityProviderStatus;
-    connectionState?: CapacityProviderConnectionState;
-}
-export interface CapacityProviderHeartbeatResponse {
-    ok: true;
-    provider?: CapacityProviderRegistrationResponse['provider'];
-    heartbeatIntervalSeconds?: number;
-}
-export interface CapacityProviderPortfolioManifest {
-    team: {
-        id: string;
-        slug: string;
-        name: string;
-    };
-    grants?: CapacityGrant[];
-    projects: CapacityProviderPortfolioProject[];
-}
-export interface CapacityProviderPortfolioProject {
-    id: string;
-    slug: string;
-    name: string;
-    repository: {
-        provider: string;
-        role?: string | null;
-        owner: string;
-        name: string;
-        defaultBranch: string;
-        cloneUrl: string;
-        currentBranch?: string | null;
-        checkoutPath?: string | null;
-        submodulePath?: string | null;
-        webUrl?: string | null;
-    };
-    repositoryTopology?: ProjectRepositoryTopology;
-    architecture?: SeedProjectArchitecture;
-    agentSpecs: {
-        root: string;
-        testsRoot: string;
-    };
-    workPolicy: {
-        enabled: boolean;
-        startCron?: string | null;
-        durationMinutes?: number | null;
-        dailyCreditBudget?: number | null;
-        maxRunners?: number | null;
-        maxWorkersPerRunner?: number | null;
-        [key: string]: unknown;
-    };
-    metadata?: Record<string, unknown>;
-}
-export interface ProviderWorkdayRequest {
-    projectId: string;
-    environment: CapacityProviderEnvironmentName;
-    idempotencyKey?: string | null;
-    kind?: string;
-    summary?: Record<string, unknown> | null;
-    metadata?: Record<string, unknown> | null;
-}
-export interface ProviderWorkdayResponse {
-    ok: true;
-    workDay: Record<string, unknown>;
-}
-export interface ProviderUsageReport {
-    taskId?: string | null;
-    workDayId?: string | null;
-    projectId?: string | null;
-    taskSignature?: string | null;
-    executionProfileId?: string | null;
-    executionProviderId?: string | null;
-    modelName?: string | null;
-    inputTokens?: number | null;
-    outputTokens?: number | null;
-    cachedInputTokens?: number | null;
-    quotaMinutes?: number | null;
-    wallMinutes?: number | null;
-    filesOpened?: number | null;
-    filesChanged?: number | null;
-    diffLinesAdded?: number | null;
-    diffLinesRemoved?: number | null;
-    testRuns?: number | null;
-    retryCount?: number | null;
-    actualCredits?: number | null;
-    actualCreditsOverride?: boolean | null;
-    actualUsd?: number | null;
-    nativeUsage?: NativeUsageObservation | Record<string, unknown> | null;
-    metadata?: Record<string, unknown> | null;
-}
-export interface ProviderUsageReportResponse {
-    ok: true;
-    usage?: Record<string, unknown>;
-}
-export interface ProviderReportRequest {
-    workDayId: string;
-    kind: string;
-    body: Record<string, unknown>;
-    renderedRef?: string | null;
-    metadata?: Record<string, unknown> | null;
-}
-export interface ProviderReportResponse {
-    ok: true;
-    report: Record<string, unknown>;
-}
-export interface CapacityProviderDeploymentIntent {
-    teamId: string;
-    capacityProviderId: string;
-    launchMode: CapacityProviderLaunchMode;
-    hostKind: string;
-    hostId?: string | null;
-    imageRef?: string | null;
-    serviceRefs?: Record<string, unknown>;
-    envRefs?: Record<string, unknown>;
-}
-export interface CapacityProviderDeploymentResult {
-    id: string;
-    teamId: string;
-    capacityProviderId: string;
-    launchMode: CapacityProviderLaunchMode;
-    hostKind: string;
-    hostId?: string | null;
-    status: CapacityProviderDeploymentStatus;
-    imageRef?: string | null;
-    serviceRefs: Record<string, unknown>;
-    envRefs: Record<string, unknown>;
-    result: Record<string, unknown>;
-    error?: Record<string, unknown> | null;
-    createdAt?: string;
-    updatedAt?: string;
-    completedAt?: string | null;
-}
-export interface CapacityProviderDeploymentServiceSpec {
-    role: CapacityProviderDeploymentServiceRole;
-    serviceName: string;
-    imageRef: string;
-    startCommand: string;
-    env: Record<string, string>;
-    redactedEnv: Record<string, string>;
-}
-export interface CapacityProviderDeploymentServiceResult {
-    role: CapacityProviderDeploymentServiceRole;
-    serviceName: string;
-    serviceId?: string | null;
-    url?: string | null;
-    status?: CapacityProviderDeploymentStatus;
-    envRefs?: Record<string, unknown>;
-    metadata?: Record<string, unknown>;
-}
-export interface CapacityProviderDeploymentAdapter {
-    provisionService(spec: CapacityProviderDeploymentServiceSpec): Promise<CapacityProviderDeploymentServiceResult> | CapacityProviderDeploymentServiceResult;
-}
-export interface CapacityProviderDeploymentPrimitiveInput {
-    intent: CapacityProviderDeploymentIntent;
-    env: Record<string, string>;
-    redactedEnv?: Record<string, string>;
-    imageRef?: string | null;
-    roleImageRefs?: Partial<Record<CapacityProviderDeploymentServiceRole, string>>;
-    serviceNamePrefix?: string | null;
-    adapter?: CapacityProviderDeploymentAdapter;
-    now?: Date;
-}
-export interface CapacityProviderDeploymentPrimitiveResult {
-    ok: boolean;
-    launchMode: CapacityProviderLaunchMode;
-    hostKind: string;
-    roleImageRefs: Record<CapacityProviderDeploymentServiceRole, string>;
-    status: CapacityProviderDeploymentStatus;
-    serviceRefs: Record<CapacityProviderDeploymentServiceRole, CapacityProviderDeploymentServiceResult>;
-    envRefs: Record<string, unknown>;
-    diagnostics: string[];
-    deployedAt?: string | null;
-    error?: Record<string, unknown> | null;
-}
-export interface CapacityProviderEnvironmentInput {
-    marketUrl: string;
-    marketId: string;
-    apiKey: string;
-    providerId?: string;
-    teamId?: string;
-    providerDataDir?: string;
-    providerEnvironment?: CapacityProviderEnvironmentName;
-    providerHostDataDir?: string;
-    capabilitiesFile?: string;
-    budgetFile?: string;
-    maxConcurrentWorkdays?: number | string;
-    maxConcurrentRunners?: number | string;
-    dailyCreditBudget?: number | string;
-    monthlyCreditBudget?: number | string;
-    codexAuthFile?: string;
-    codexAuthJsonB64?: string;
-    codexAuthOverwrite?: boolean | number | string;
-}
-export interface CapacityProviderRoleImageConfig {
-    image?: string;
-    tag?: string;
-}
-export interface CapacityProviderImageExtensionConfig {
-    enabled?: boolean;
-    baseImage?: string;
-    dockerfile?: string;
-    context?: string;
-    image?: string;
-    tag?: string;
-    buildArgs?: Record<string, string | number | boolean | null | undefined>;
-}
-export interface CapacityProviderLaunchManifest {
-    schemaVersion: 1;
-    provider?: {
-        id?: string;
-        environment?: string;
-        dataDir?: string;
-        market?: {
-            profile?: string;
-            url?: string;
-            id?: string;
-        };
-    };
-    runtime?: {
-        images?: {
-            tag?: string;
-            architecture?: 'auto' | 'amd64' | 'arm64' | string;
-            pullPolicy?: string;
-            roles?: Partial<Record<CapacityProviderDeploymentServiceRole, CapacityProviderRoleImageConfig>>;
-        };
-        manager?: {
-            pollSeconds?: number | string;
-        };
-        runners?: {
-            count?: number | string;
-            maxConcurrent?: number | string;
-            dataDir?: string;
-        };
-    };
-    extensions?: Partial<Record<CapacityProviderDeploymentServiceRole, CapacityProviderImageExtensionConfig>>;
-    executionProviders?: unknown[];
-    capabilities?: unknown[];
-}
-export interface CapacityProviderLaunchPlan {
-    manifest: CapacityProviderLaunchManifest;
-    roleImages: Record<CapacityProviderDeploymentServiceRole, string>;
-    composeEnv: Record<string, string>;
-    redactedEnv: Record<string, string>;
-}
-export interface CapacityProviderSelfHostInstructions {
-    composeFile: string;
-    commands: string[];
-    env: Record<string, string>;
-    redactedEnv: Record<string, string>;
-    summary: string;
-}
-export interface CapacityProviderLaunchEnvironmentInput {
-    tenantRoot?: string | null;
-    scope?: 'local' | 'staging' | 'prod' | string;
-    env?: NodeJS.ProcessEnv;
-    overrides?: Record<string, string | number | boolean | null | undefined>;
-    requireConnection?: boolean;
-    diagnostic?: boolean;
-}
-export interface CapacityProviderLaunchEnvironment {
-    env: Record<string, string>;
-    redactedEnv: Record<string, string>;
-    missing: string[];
-    diagnostic: boolean;
-    source: 'treeseed-config' | 'process-env';
-}
-export interface CapacityProviderConnectionConfigInput extends CapacityProviderEnvironmentInput {
-    tenantRoot: string;
-    scope?: 'local' | 'staging' | 'prod' | string;
-    providerHostDataDir?: string;
-    providerEnvironment?: CapacityProviderEnvironmentName;
-}
-export interface CapacityProviderConnectionConfigResult {
-    env: Record<string, string>;
-    redactedEnv: Record<string, string>;
-    scope: string;
-    writtenKeys: string[];
-}
-export interface MarketProviderClientOptions extends CapacityProviderEnvironmentInput {
-    fetchImpl?: typeof fetch;
-    userAgent?: string;
-    requestTimeoutMs?: number;
-}
-export declare class CapacityProviderApiError extends Error {
-    readonly status: number;
-    readonly payload: unknown;
-    constructor(message: string, status: number, payload: unknown);
-}
-export declare function buildCapacityProviderAuthHeaders(apiKey: string): {
-    authorization: string;
-};
-export declare function assertCapacityProviderOkEnvelope(value: unknown, label?: string): asserts value is {
-    ok: true;
-};
-export declare function assertCapacityProviderRegistrationResponse(value: unknown): asserts value is CapacityProviderRegistrationResponse;
-export declare function assertCapacityProviderPortfolioManifest(value: unknown): asserts value is CapacityProviderPortfolioManifest;
-export declare function resolveCapacityProviderEnvironment(input: CapacityProviderEnvironmentInput): Record<string, string>;
-export declare function resolveCapacityProviderLaunchEnvironment(input?: CapacityProviderLaunchEnvironmentInput): CapacityProviderLaunchEnvironment;
-export declare function persistCapacityProviderConnectionToTreeseedConfig(input: CapacityProviderConnectionConfigInput): CapacityProviderConnectionConfigResult;
-export declare function redactCapacityProviderSecret(value: string): string;
-export declare function isCapacityProviderSecretEnvKey(key: string): boolean;
-export declare function redactCapacityProviderEnv(env: Record<string, string>): Record<string, string>;
-export declare function parseCapacityProviderLaunchManifest(source: string | Record<string, unknown>): CapacityProviderLaunchManifest;
-export declare function resolveCapacityProviderLaunchPlan(manifest: CapacityProviderLaunchManifest): CapacityProviderLaunchPlan;
-export declare function renderCapacityProviderSelfHostInstructions(input: CapacityProviderEnvironmentInput): CapacityProviderSelfHostInstructions;
-export declare function deployCapacityProviderToRailway(input: CapacityProviderDeploymentPrimitiveInput): Promise<CapacityProviderDeploymentPrimitiveResult>;
-export declare function deployCapacityProviderToManagedMarketHost(input: CapacityProviderDeploymentPrimitiveInput): Promise<CapacityProviderDeploymentPrimitiveResult>;
-export declare class MarketProviderClient {
-    private readonly marketUrl;
-    private readonly marketId;
-    private apiKey;
-    private readonly fetchImpl;
-    private readonly userAgent?;
-    private readonly requestTimeoutMs;
-    constructor(options: MarketProviderClientOptions);
-    private requestJson;
-    register(request: Omit<CapacityProviderRegistrationRequest, 'marketId'> & {
-        marketId?: string;
-    }): Promise<CapacityProviderRegistrationResponse>;
-    heartbeat(request?: Omit<CapacityProviderHeartbeatRequest, 'marketId'> & {
-        marketId?: string;
-    }): Promise<CapacityProviderHeartbeatResponse>;
-    createAvailabilitySession(request?: Record<string, unknown>): Promise<{
-        ok: true;
-        payload: Record<string, unknown>;
-    }>;
-    checkIn(request?: ProviderCheckInRequest): Promise<{
-        ok: true;
-        payload: Record<string, unknown>;
-    }>;
-    portfolio(): Promise<CapacityProviderPortfolioManifest>;
-    createWorkday(request: ProviderWorkdayRequest): Promise<ProviderWorkdayResponse>;
-    assignment(assignmentId: string): Promise<{
-        ok: true;
-        payload: Record<string, unknown>;
-    }>;
-    assignmentExplanation(assignmentId: string): Promise<{
-        ok: true;
-        payload: Record<string, unknown>;
-    }>;
-    nextAssignment(request?: ProviderNextAssignmentRequest): Promise<ProviderAssignmentLifecycleResult>;
-    renewAssignment(assignmentId: string, request?: ProviderAssignmentLifecycleRequest): Promise<ProviderAssignmentLifecycleResult>;
-    returnAssignment(assignmentId: string, request?: ProviderAssignmentLifecycleRequest): Promise<ProviderAssignmentLifecycleResult>;
-    completeAssignment(assignmentId: string, request?: ProviderAssignmentLifecycleRequest): Promise<ProviderAssignmentLifecycleResult>;
-    failAssignment(assignmentId: string, request?: ProviderAssignmentLifecycleRequest): Promise<ProviderAssignmentLifecycleResult>;
-    createAssignmentModeRun(assignmentId: string, request: Record<string, unknown>): Promise<{
-        ok: true;
-        payload: Record<string, unknown>;
-    }>;
-    dispatchAssignmentWorkflowOperation(assignmentId: string, operationId: string, request: Record<string, unknown>): Promise<{
-        ok: true;
-        payload: Record<string, unknown>;
-    }>;
-    reportUsage(request: ProviderUsageReport): Promise<ProviderUsageReportResponse>;
-    writeReport(request: ProviderReportRequest): Promise<ProviderReportResponse>;
-}