@synteq/cli 0.2.0 → 1.1.2

package/dist/api/types.d.ts

@@ -63,8 +63,6 @@ export interface Resource {
     project_name: string | null;
     created_at: string;
     ip_addresses?: ResourceIp[];
-    node?: string;
-    vmid?: number;
     cluster_id?: string;
     managed_os?: string | null;
     last_installed_os?: string | null;
@@ -186,6 +184,11 @@ export interface PaymentMethod {
     is_default: boolean;
     is_active: boolean;
 }
+/** GET /payments/touchpoints/{touchpoint}/payment-methods row. */
+export interface PaymentMethodEligibility extends PaymentMethod {
+    eligible: boolean;
+    ineligible_reason: string | null;
+}
 export interface SetDefaultMethodOut {
     id: string;
     is_default: boolean;
@@ -377,6 +380,24 @@ export interface OrderResultOut {
     credits_applied?: string | null;
     failure_reason?: string | null;
 }
+export interface PreviewOrderIn {
+    kind: "virtualized" | "block_volume" | "baremetal" | "addon" | "resize";
+    spec: Record<string, unknown>;
+    quantity?: number;
+}
+export interface PreviewOrderOut {
+    amount: string;
+    currency: string;
+    subtotal: string;
+    tax_total: string;
+    total: string;
+    tax_breakdown?: {
+        jurisdiction?: string;
+        rate?: string;
+    }[];
+    estimate_degraded?: boolean;
+    tax_label?: string;
+}
 export interface StorageCatalog {
     is_active: boolean;
     pricing_mode: string;
@@ -473,9 +494,29 @@ export interface AddonAttachOut {
     checkout_url: string | null;
     credits_applied: string | null;
     failure_reason: string | null;
-    amount_paid: number;
+    /** Decimal on the wire — arrives as a string like `credits_applied`; go
+     *  through `Number()` before any arithmetic or `.toFixed`. */
+    amount_paid: number | string;
     billing_mode: string;
 }
+export interface AddonQuoteIn {
+    addon_key: string;
+    count: number;
+    billing_mode?: "prorate" | "new_cycle";
+}
+export interface AddonQuoteOut {
+    subtotal: string;
+    tax_total: string;
+    total: string;
+    tax_breakdown: {
+        jurisdiction?: string;
+        rate?: string;
+    }[];
+    tax_recurring: string;
+    total_recurring: string;
+    tax_label?: string;
+    estimate_degraded?: boolean;
+}
 export interface AddonRemoveOut {
     id: string;
     status: string;
@@ -567,6 +608,19 @@ export interface ResourceResizeQuoteOut {
     out_of_stock_reason?: string | null;
     credit_balance_available?: string;
     can_switch_to_dedicated?: boolean;
+    billing_cycle?: string;
+    cycle_price?: string;
+    new_cycle_price?: string;
+    tax_today?: string;
+    total_today?: string;
+    tax_recurring?: string;
+    total_recurring?: string;
+    tax_breakdown?: {
+        jurisdiction?: string;
+        rate?: string;
+    }[];
+    tax_label?: string;
+    estimate_degraded?: boolean;
 }
 export interface ResourceResizeOut {
     status: string;
@@ -603,6 +657,16 @@ export interface BlockVolumeResizeQuoteOut {
     monthly_delta: string;
     prorated_amount: string;
     currency: string;
+    tax_today?: string;
+    total_today?: string;
+    tax_breakdown?: {
+        jurisdiction?: string;
+        rate?: string;
+    }[];
+    tax_recurring?: string;
+    total_recurring?: string;
+    tax_label?: string;
+    estimate_degraded?: boolean;
 }
 export interface BlockVolumeResizeIn {
     new_size_gb: number;
@@ -747,3 +811,828 @@ export interface TicketMessageIn {
 export interface TicketStatusIn {
     status: TicketStatus;
 }
+export interface BaremetalIp {
+    address: string;
+    version?: number;
+    ptr_record?: string | null;
+}
+export interface BaremetalService {
+    id: string;
+    location_name: string | null;
+    location_city: string | null;
+    location_country: string | null;
+    reference: string;
+    hostname: string | null;
+    /** Install profile id of the last OS Synteq installed, or null when the
+     *  server was handed off with no install by us. */
+    installed_os?: string | null;
+    cpu_model: string | null;
+    cpu_cores: number | null;
+    ram_gb: number | null;
+    storage_summary: string | null;
+    primary_ipv4: string | null;
+    primary_ipv6: string | null;
+    ip_addresses: string[];
+    ip_details: BaremetalIp[];
+    location_agent_connected: boolean;
+    ila_managed: boolean;
+    ila_reachable: boolean | null;
+    hardware: Record<string, unknown> | null;
+    capabilities: Record<string, unknown> | null;
+    rack_name: string | null;
+    rack_position: number | null;
+    monthly_price: number;
+    next_due: string | null;
+    is_active: boolean;
+    created_at: string | null;
+    project_id: string | null;
+    project_name: string | null;
+}
+export interface BaremetalInvoiceLine {
+    id: number;
+    description: string;
+    quantity: number;
+    unit_amount: number;
+    line_amount: number;
+}
+export interface BaremetalInvoice {
+    id: number;
+    invoice_number: string;
+    status: string;
+    raw_status: string;
+    is_overdue: boolean;
+    currency: string;
+    total: number;
+    amount_due: number;
+    amount_paid: number;
+    due_date: string;
+    created_at: string;
+    matching_lines: BaremetalInvoiceLine[];
+    other_line_count: number;
+}
+export interface BaremetalPowerState {
+    power_state: string | null;
+    bmc_reachable: boolean | null;
+    /** ILA's legacy single field: the PXE job when both domains are busy. */
+    active_job_id: string | null;
+    /** One active job per domain per server (ILA 2026.8.18). Optional so an
+     *  older portal that does not echo them still parses. */
+    active_pxe_job_id?: string | null;
+    active_power_job_id?: string | null;
+}
+export type BaremetalPowerAction = "on" | "off" | "graceful_off" | "cycle" | "reset" | "graceful_restart";
+export interface BaremetalJobResult {
+    job_id: string | null;
+    state: string | null;
+}
+export interface BaremetalInstallProfile {
+    id: string;
+    name?: string | null;
+    os_name?: string | null;
+    os_version?: string | null;
+    description?: string | null;
+    estimated_minutes?: number | null;
+}
+export interface BaremetalJob {
+    id: string | null;
+    state: string | null;
+    active: boolean;
+    boot_profile: string | null;
+    created_at: string | null;
+    started_at: string | null;
+    completed_at: string | null;
+    /** Over without having done its work: failed, timed out, cancelled, or
+     *  replaced by a newer operation ("Replaced" / ILA `superseded`). */
+    failed: boolean;
+    /** "pxe" (install / rescue) or "power" (a power press). */
+    domain?: "pxe" | "power" | string | null;
+}
+export interface BaremetalJobEvent {
+    event_type: string | null;
+    new_state: string | null;
+    message: string | null;
+    created_at: string | null;
+}
+export interface BaremetalInstallPasswordStatus {
+    available: boolean;
+}
+export interface BaremetalInstallPasswordOut {
+    password: string;
+}
+export interface BaremetalStorageVolumeIn {
+    name: string;
+    size: string;
+    mountpoint?: string | null;
+    type?: "filesystem" | "swap" | "thinpool";
+    fs?: "ext4" | "xfs" | null;
+}
+export interface BaremetalDiskSelectorIn {
+    type?: "ssd" | "hdd" | "nvme" | null;
+    size_min?: string | null;
+    size_max?: string | null;
+    count?: number | null;
+}
+export interface BaremetalStoragePoolIn {
+    role: "os" | "storage" | "cache";
+    select?: BaremetalDiskSelectorIn;
+    raid?: 0 | 1 | 5 | 6 | 10 | null;
+    volumes: BaremetalStorageVolumeIn[];
+}
+export interface BaremetalStorageLayoutIn {
+    profile?: string | null;
+    pools: BaremetalStoragePoolIn[];
+}
+export interface BaremetalReinstallIn {
+    install_profile: string;
+    hostname?: string | null;
+    ssh_public_key?: string | null;
+    storage?: BaremetalStorageLayoutIn | null;
+    confirm_reference: string;
+    password_challenge: string;
+}
+export interface BaremetalCatalogOffer {
+    offering_id: string;
+    title: string | null;
+    location: string | null;
+    location_code: string | null;
+    location_city: string | null;
+    location_country: string | null;
+    monthly_price: string;
+    setup_fee: string | null;
+    included_tb: number | null;
+    setup_estimate_minutes: number | null;
+    hardware: Record<string, unknown> | null;
+    capabilities: Record<string, unknown>;
+}
+export interface BaremetalCatalogGroup {
+    location: string | null;
+    location_code: string | null;
+    location_city: string | null;
+    location_country: string | null;
+    offers: BaremetalCatalogOffer[];
+}
+export interface BaremetalCatalogOut {
+    groups: BaremetalCatalogGroup[];
+}
+export interface BaremetalOrderSpec {
+    offering_id: string;
+    project_id: string;
+    hostname: string;
+    /** "none" hands the machine off as-is; "profile" installs `install_profile`. */
+    install_mode: "none" | "profile";
+    install_profile?: string;
+    ssh_key_id?: string;
+    ssh_public_key?: string;
+    storage?: BaremetalStorageLayoutIn;
+}
+/** GET /apps-plans → PlanOut. `name` is the tier id sent as AppCreateIn.planTier
+ *  ("free" | "hobby" | "starter" | "pro"); `displayName` is the label. */
+/** One placeable apps cluster from GET /apps/locations (customer-safe fields
+ *  only). Several clusters can share a datacenter; `code`/`city` come from the
+ *  cluster's linked Location and are null when it has none. */
+export interface AppLocation {
+    clusterId: string;
+    region: string;
+    name: string;
+    code?: string | null;
+    city?: string | null;
+    country?: string | null;
+}
+export interface AppPlan {
+    name: string;
+    displayName?: string;
+    isFree?: boolean;
+    /** Packed source-upload cap for apps on this plan, MB (srccap1). */
+    maxSourceMb?: number | null;
+    /** Unpacked cap, MB. */
+    maxUnpackedMb?: number | null;
+    sleepsWhenIdle?: boolean;
+    allowCustomDomains?: boolean;
+    cpuMillicores?: number;
+    memoryMib?: number;
+    maxReplicas?: number;
+    monthlyAnchorUsd?: string | number;
+    /** Per-team cap on THIS tier and how many live apps the caller already has
+     *  on it (backend surfaces both). Together they say whether the tier is
+     *  pickable — a Free-only user at their two-app cap should not be handed
+     *  Free as a choice and then 4xx'd on Create. */
+    maxAppsPerTeam?: number | null;
+    teamAppsOnTier?: number;
+    /** Pro boxes (2026-09-23): a dedicated tier the capacity cron's cache
+     *  says has zero fit. Absent/true = pickable (fail-open, same as the
+     *  backend's PlanOut default). */
+    available?: boolean;
+    unavailableReason?: string | null;
+}
+/** GET /apps , GET /apps/{id} , POST /apps → AppOut. */
+export interface App {
+    id: string;
+    projectId: string;
+    teamId: string;
+    slug: string;
+    hostname: string;
+    planTier: string;
+    region: string;
+    replicas: number;
+    status: string;
+    activeRelease: number;
+    createdAt: string;
+    /** The linked GitHub repository (owner/repo), when the app deploys from one. */
+    githubRepoFullName?: string | null;
+}
+/** GET /apps/by-repo → an app that deploys from a repo, with its org and
+ *  project named — the search spans every team the user is in. */
+export interface AppByRepo extends App {
+    teamName: string;
+    projectName: string;
+}
+/** POST /apps body → AppCreateIn (camelCase; slug required). */
+/** POST /apps/check-name → NameCheckOut. `reason` is one of ok / invalid_shape / banned / taken. */
+export interface AppNameCheck {
+    slug: string;
+    available: boolean;
+    reason: string;
+    hostname?: string | null;
+}
+export interface AppCreateIn {
+    slug: string;
+    planTier?: string;
+    region?: string;
+}
+/** GET /apps/{id}/builds/{id} → BuildDetailOut (BuildOut + steps/actor). */
+export interface BuildDetail extends Build {
+    triggeredBy?: {
+        userId?: string;
+        name: string;
+        avatarUrl?: string;
+    } | null;
+    steps?: {
+        id: string;
+        label: string;
+        status: string;
+        durationMs?: number | null;
+        log?: string[];
+    }[];
+    artifacts?: unknown[];
+}
+/** One parsed line of GET /apps/{id}/logs/history's `lines` (the WS tail's
+ *  own shape, build-stamped). */
+export interface LogLine {
+    ts?: string;
+    container?: string;
+    pod?: string;
+    /** Release label ("r36") the line's instance belonged to, when known. */
+    build?: string;
+    message?: string;
+    level?: string;
+}
+/** GET /apps/{id}/logs/history → the orchestrator's log payload (loose). */
+export interface LogHistory {
+    lines?: LogLine[];
+    entries?: LogLine[];
+    [k: string]: unknown;
+}
+/** One metric axis of an app's live payload: the current value plus the
+ *  window's points. CPU is millicores, memory is bytes, network is bytes/s. */
+export interface AppMetricSeries {
+    current: number;
+    series: {
+        ts: string;
+        value: number;
+    }[];
+}
+export interface AppMetricsPayload {
+    cpu?: AppMetricSeries;
+    memory?: AppMetricSeries;
+    networkRx?: AppMetricSeries;
+    networkTx?: AppMetricSeries;
+}
+/** GET /apps/{id}/usage → AppUsageOut: snapshot series, the live current
+ *  payload (null when the orchestrator cannot answer) and the plan envelope
+ *  the meters run against (the app's EFFECTIVE spec). */
+export interface AppUsage {
+    series: {
+        takenAt: string;
+        payload: AppMetricsPayload;
+    }[];
+    current: AppMetricsPayload | null;
+    envelope: {
+        cpuMillicores: number;
+        memoryMib: number;
+        diskGb?: number | null;
+        bandwidthGbMonth?: number | null;
+        bandwidthUsedGb?: number | null;
+    } | null;
+}
+/** GET /apps/{id}/health-check → AppHealthCheckOut. */
+export interface AppHealth {
+    ok: boolean;
+    status?: number | null;
+    latencyMs?: number | null;
+    detail?: string | null;
+}
+/** GET/POST /apps/{id}/domains → DomainOut. */
+export interface AppDomain {
+    id: string;
+    appId: string;
+    domain: string;
+    isDefault: boolean;
+    isPrimary: boolean;
+    tlsStatus: string;
+    cnameTarget?: string | null;
+    verificationToken?: string | null;
+    failureReason?: string | null;
+    isApex?: boolean;
+    routingRecord?: {
+        type?: string;
+        name?: string;
+        value?: string;
+    } | null;
+    dnsRecords?: {
+        type?: string;
+        name?: string;
+        value?: string;
+    }[];
+}
+/** GET /apps/{id}/plan/preview → PlanPreviewOut. */
+export interface PlanChangePreview {
+    action: string;
+    proratedCharge: string;
+    newMonthly: string;
+    tax: string;
+    belowUsage: boolean;
+    p95Cpu?: number | null;
+    p95Mem?: number | null;
+}
+/** PATCH /apps/{id}/plan → PlanChangeOut. */
+export interface PlanChange {
+    action: string;
+    planTier: string;
+    proratedCharge: string;
+    tax: string;
+    newMonthly: string;
+    pendingPlanTier?: string | null;
+    pendingPlanTierAt?: string | null;
+    invoiceId?: string | null;
+    chargeId?: string | null;
+    creditId?: string | null;
+}
+/** GET/PATCH /apps/{id}/settings → AppSettingsOut. */
+export interface AppSettings {
+    rootDirectory?: string | null;
+    dockerfilePath?: string | null;
+    buildContext?: string | null;
+    dockerCommand?: string | null;
+    preDeployCommand?: string | null;
+    autoDeploy: string;
+    healthCheckPath?: string | null;
+    buildFilterIncluded?: string[];
+    buildFilterIgnored?: string[];
+    /** The port the app listens on, as explicitly chosen by the customer, or
+     *  null when they never chose one — in which case the runtime detects it
+     *  and falls back to `effectivePort`. 1-65535; the API 422s outside that. */
+    port?: number | null;
+    /** READ-ONLY. What the app is actually probed and routed on today. Never
+     *  send it — see AppSettingsPatch. */
+    effectivePort: number;
+}
+/** Body of PATCH /apps/{id}/settings. `effectivePort` is server-derived and
+ *  read-only, so it is omitted here rather than left patchable by a bare
+ *  `Partial<AppSettings>` — mirroring the portal frontend's own guard. */
+export type AppSettingsPatch = Partial<Omit<AppSettings, "effectivePort">>;
+/** GET /apps/{id}/builds , POST /apps/{id}/deploys → BuildOut. */
+export interface Build {
+    id: string;
+    appId: string;
+    sourceKind: string;
+    sourceRef?: string | null;
+    commitSha?: string | null;
+    commitMessage?: string | null;
+    frontend: string;
+    status: string;
+    imageDigest?: string | null;
+    cacheHit: boolean;
+    startedAt?: string | null;
+    finishedAt?: string | null;
+    /** The orchestrator's one-line reason for a failed build (a pull that
+     *  could not resolve credentials, a Dockerfile step that exited 1). */
+    failureReason?: string | null;
+    /** Where a pending build stands in the build queue ("position N of M")
+     *  and, once running, the build VM it was admitted to (bpool1). */
+    queuePosition?: number | null;
+    queueTotal?: number | null;
+    builder?: string | null;
+}
+/** POST /apps/{id}/deploys/source/upload-url → SourceUploadUrlOut. `headers`
+ *  are the exact headers to send on the PUT (its signature covers
+ *  `Content-Length`; anything else is refused with 403). Never log or print
+ *  `uploadUrl`/`objectKey` in normal output — the URL is itself a bearer
+ *  credential for the object. */
+export interface SourceUploadUrlOut {
+    uploadUrl: string;
+    objectKey: string;
+    expiresAt: string | null;
+    method: string;
+    headers: Record<string, string>;
+}
+/** POST /apps/{id}/deploys body → DeployIn (camelCase). */
+export interface DeployIn {
+    sourceKind?: string;
+    sourceUrl?: string;
+    sourceRef?: string;
+    frontend?: string;
+    imageRef?: string;
+    rollbackToRelease?: number;
+}
+/** GET /apps/{id}/releases → ReleaseOut (subset the CLI renders). */
+export interface Release {
+    id: string;
+    appId: string;
+    /** The build this release rolled out. Null for image-ref / seeded rows
+     *  with no source build. `app deployment show` needs this id. */
+    buildId?: string | null;
+    number: number;
+    imageDigest: string;
+    commitSha?: string | null;
+    commitMessage?: string | null;
+    status: string;
+    /** Why a health_failed / start_failed release failed: the orchestrator's
+     *  reason plus the guest console tail. Null unless the release failed. */
+    failureReason?: string | null;
+    isCurrent: boolean;
+    deployedAt: string;
+}
+/** GET /apps/{id}/env → EnvVarOut. Values are never returned (hasValue only). */
+export interface EnvVar {
+    id: string;
+    appId: string;
+    key: string;
+    scope: string;
+    /** "secret" (reveal masks) | "config" (reveal returns plaintext). */
+    kind?: string;
+    note?: string | null;
+    hasValue: boolean;
+    updatedAt: string;
+}
+/** PUT /apps/{id}/env body → EnvVarSetIn (value is write-only). */
+export interface EnvVarSetIn {
+    key: string;
+    value: string;
+    scope?: string;
+    /** "secret" (default) | "config". */
+    kind?: string;
+    note?: string;
+    /** false = save without the auto rollout (applies on the next deploy). */
+    rollout?: boolean;
+}
+/** GET/POST /apps/{id}/github/link → GithubLinkOut (camelCase; GET is null when unlinked). */
+export interface GithubLink {
+    id: string;
+    appId: string;
+    installationId: string;
+    repoFullName: string;
+    branch: string;
+    createdAt: string;
+    /** POST only: the build a NEW app's link started from the branch head. */
+    deploy?: {
+        buildId: string;
+        commitSha: string | null;
+        commitMessage: string | null;
+    } | null;
+    /** POST only: why no build started (the app has deployed before, the head was unreadable…). */
+    deploySkipped?: string | null;
+}
+/** POST /apps/{id}/github/link body → GithubLinkIn. */
+export interface GithubLinkIn {
+    installationId: string;
+    repoFullName: string;
+    branch?: string;
+}
+/** POST /auth/ws-ticket → WsTicketOut. */
+export interface WsTicket {
+    ticket: string;
+}
+/** GET /functions row → FunctionOut. */
+export interface Fn {
+    id: string;
+    slug: string;
+    hostname: string;
+    planTier: string;
+    region: string;
+    status: string;
+    memoryMib: number;
+    /** "node22" | "python312" — always concrete on the wire (never null). */
+    runtime: string;
+    concurrency: number;
+    timeoutSeconds: number;
+    minInstances: number;
+    maxInstances: number;
+    monthlyBudgetUsd?: string | number | null;
+    budgetState: string;
+    pausedReason?: string | null;
+    createdAt: string;
+    deletedAt?: string | null;
+    currentReleaseNumber?: number | null;
+    currentReleaseDeployedAt?: string | null;
+    healthStatus?: string | null;
+    healthCheckedAt?: string | null;
+    /** The admin's source cap in bytes (portal setting); absent on older backends. */
+    maxSourceBytes?: number | null;
+    /** The API's file-count cap on a source deploy; absent on older backends. */
+    maxSourceFiles?: number | null;
+}
+export interface FnListOut {
+    items: Fn[];
+    total: number;
+}
+/** POST /functions body → FunctionCreateIn. Exactly one of locationId / region. */
+export interface FnCreateIn {
+    name: string;
+    planTier: string;
+    runtime?: string;
+    locationId?: string;
+    region?: string;
+}
+/** GET /functions-plans → FunctionPlansOut.plans[] */
+export interface FnPlan {
+    id: string;
+    name: string;
+    displayName: string;
+    memoryMib: number;
+    cpuMillicores: number;
+    defaultConcurrency: number;
+    maxConcurrency: number;
+    defaultTimeoutSeconds: number;
+    maxTimeoutSeconds: number;
+    pricePerMillionInvocationsUsd?: string | number | null;
+    pricePerGbSecondUsd?: string | number | null;
+    keepWarmMonthlyUsd?: string | number | null;
+}
+/** GET /functions-locations row. `region` is what POST /functions takes. */
+export interface FnLocation {
+    locationId: string;
+    code: string;
+    city: string;
+    country: string;
+    region?: string;
+}
+/** POST /functions/check-name → NameCheckOut. */
+export interface FnNameCheck {
+    slug: string;
+    available: boolean;
+    reason?: string | null;
+    hostname?: string | null;
+}
+/** One pasted source file. The backend tars these server-side. */
+export interface FnSourceFile {
+    path: string;
+    content: string;
+}
+/** GET /functions/{id}/source → FnSourceOut. `files: []` = not re-openable. */
+export interface FnSource {
+    files: FnSourceFile[];
+    packageBytes?: number | null;
+    deployedAt?: string | null;
+    buildId?: string | null;
+    releaseNumber?: number | null;
+}
+/** GET /functions/{id}/builds row → FnBuildOut. status: pending|building|pushing|succeeded|failed. */
+export interface FnBuild {
+    id: string;
+    functionId: string;
+    sourceKind: string;
+    sourceRef?: string | null;
+    commitSha?: string | null;
+    commitMessage?: string | null;
+    /** "dockerfile" | "railpack" | "bundle" — decided server-side, never sent. */
+    frontend: string;
+    status: string;
+    imageTag: string;
+    imageDigest?: string | null;
+    bundleDigest?: string | null;
+    createdAt: string;
+    startedAt?: string | null;
+    finishedAt?: string | null;
+}
+/** GET /functions/{id}/releases row → FnReleaseOut. */
+export interface FnRelease {
+    id: string;
+    functionId: string;
+    buildId?: string | null;
+    number: number;
+    imageDigest: string;
+    bundleDigest?: string | null;
+    commitSha?: string | null;
+    commitMessage?: string | null;
+    status: string;
+    isCurrent: boolean;
+    deployedAt: string;
+}
+/** POST /functions/{id}/rollback → {release, rolledBackTo}. */
+export interface FnRollbackOut {
+    release: number;
+    rolledBackTo: number;
+}
+/** One outbound HTTP call a run made. `status` null = never completed. */
+export interface FnOutboundCall {
+    method?: string | null;
+    url: string;
+    status?: number | null;
+    durationMs?: number | null;
+    error?: string | null;
+}
+/** GET /functions/{id}/runs row → FnRunOut. */
+export interface FnRun {
+    id: string;
+    functionId: string;
+    releaseNumber?: number | null;
+    startedAt: string;
+    durationMs?: number | null;
+    status: string;
+    statusCode?: number | null;
+    error?: string | null;
+    requestId?: string | null;
+    /** null = runtime captured nothing; [] = the run printed nothing. */
+    logLines?: string[] | null;
+    logTruncated?: boolean;
+    outbound?: FnOutboundCall[] | null;
+    outboundTruncated?: boolean;
+}
+export interface FnRunListOut {
+    items: FnRun[];
+    total?: number | null;
+    nextBefore?: string | null;
+}
+/** GET /functions/{id}/env row → FnEnvVarOut. Values are never listed. */
+export interface FnEnvVar {
+    id: string;
+    key: string;
+    scope: string;
+    /** "secret" (reveal is masked to the last 4) | "config" (reveal is full). */
+    kind: string;
+    note?: string | null;
+    updatedAt: string;
+}
+/** GET /functions/{id}/triggers/cron → CronTriggerOut[]. A trigger POSTs the
+ *  function's own public hostname on `schedule` (5-field cron, UTC), so a cron
+ *  run meters and logs like any other invocation. */
+export interface FnCronTrigger {
+    id: string;
+    schedule: string;
+    enabled: boolean;
+    /** Re-fires after a failed run, 0-2. */
+    retries: number;
+    lastRunAt?: string | null;
+    lastStatus?: string | null;
+    description?: string | null;
+    createdAt: string;
+    createdBy?: string | null;
+    createdByUserId?: string | null;
+}
+/** POST /functions/{id}/triggers/cron body → CronTriggerCreateIn. */
+export interface FnCronTriggerCreateIn {
+    schedule: string;
+    enabled?: boolean;
+    retries?: number;
+    description?: string | null;
+}
+/** PATCH /functions/{id}/triggers/cron/{triggerId} body → CronTriggerUpdateIn.
+ *  Absent keys are left as they are. */
+export type FnCronTriggerUpdateIn = Partial<FnCronTriggerCreateIn>;
+/** PUT /functions/{id}/env body → FnEnvVarSetIn (value is write-only). */
+export interface FnEnvVarSetIn {
+    key: string;
+    value: string;
+    scope?: string;
+    kind?: string;
+    note?: string | null;
+    /** false = save without the auto rollout (applies on the next deploy). */
+    rollout?: boolean;
+}
+/** POST /functions/{id}/env/{key}/reveal → EnvRevealOut. For a secret the
+ *  value arrives ALREADY MASKED ("…" + last 4) — the plaintext never crosses. */
+export interface FnEnvReveal {
+    key: string;
+    value: string;
+    kind: string;
+    masked: boolean;
+}
+/** PATCH /functions/{id} body (subset the CLI drives). */
+export interface FnUpdateIn {
+    runtime?: string;
+    concurrency?: number;
+    timeoutSeconds?: number;
+    minInstances?: number;
+    maxInstances?: number;
+    paused?: boolean;
+}
+type FnMoney = string | number | null;
+/** The three auto-reload fields both billing views (and both PUTs) return. */
+export interface FnAutoReloadState {
+    autoReloadEnabled: boolean;
+    autoReloadRuns: number | null;
+    /** null = "fire below one reload's worth". */
+    autoReloadThresholdRuns: number | null;
+}
+/** GET /functions/{id}/billing → the function's Billing card. `plan` is null
+ *  when no commercial plan applies (the ships-off shape, which also omits the
+ *  credit and auto-reload fields). */
+export interface FnBilling extends Partial<FnAutoReloadState> {
+    functionId: string;
+    /** "function" | "team" | null — which pool this function's runs draw from. */
+    source: string | null;
+    plan: {
+        id: string;
+        name: string;
+        displayName: string | null;
+        scope: string;
+        billingMode: string;
+        monthlyPriceUsd: FnMoney;
+        includedRunsMonth: number | null;
+        isFreeTier?: boolean;
+    } | null;
+    periodStart: string;
+    runsUsed: number;
+    includedRunsMonth: number | null;
+    runsRemaining: number | null;
+    projectedChargeUsd?: FnMoney;
+    pausedReason?: string | null;
+    planLimitPaused?: boolean;
+    /** Divisor for displaying per-run rates: 1, 1000 or 1000000. */
+    runPriceUnit?: number;
+    /** Null unless the plan sells run credits. */
+    creditRateUsd?: FnMoney;
+    creditMonthlyGrantRuns?: number | null;
+    creditMinRuns?: number | null;
+    creditMaxRuns?: number | null;
+    creditStepRuns?: number | null;
+    isCreditsOffering?: boolean;
+    creditBalance?: number | null;
+    creditFreeBalance?: number | null;
+}
+/** GET /functions-team-billing → the team pool. `hasTeamPlan=false` means
+ *  functions bill individually and nothing else below is present. */
+export interface FnTeamBilling extends Partial<FnAutoReloadState> {
+    hasTeamPlan: boolean;
+    paymentMethodOnFile?: boolean;
+    plan?: {
+        id: string;
+        name: string;
+        displayName: string | null;
+        billingMode: string;
+        isFreeTier?: boolean;
+        includedRunsMonth: number | null;
+        creditRateUsd: FnMoney;
+        creditMonthlyGrantRuns: number | null;
+        creditMinRuns: number | null;
+        creditMaxRuns: number | null;
+        creditStepRuns: number | null;
+        monthlyPriceUsd: FnMoney;
+    };
+    isCreditsOffering?: boolean;
+    periodStart?: string;
+    periodResetsAt?: string;
+    runsUsed?: number;
+    runsRemaining?: number | null;
+    creditBalance?: number | null;
+    creditFreeBalance?: number;
+    creditPaidBalance?: number;
+    runPriceUnit?: number;
+}
+/** PUT /functions/{id}/credits/auto-reload and /functions-team-credits/auto-reload
+ *  body → FnAutoReloadIn. `runs` is required to arm; disarming clears both. */
+export interface FnAutoReloadIn {
+    enabled: boolean;
+    runs?: number;
+    threshold_runs?: number;
+}
+/** POST …/credits/purchase (and the team quote) body → FnCreditsPurchaseIn.
+ *  A QUANTITY of runs, never a price: the server prices it. */
+export interface FnCreditsPurchaseIn {
+    runs: number;
+    payment_method_id?: string;
+    apply_credits?: boolean;
+    bitpay_redirect_url?: string;
+}
+/** POST /functions-team-credits/quote → priced quote, tax included. */
+export interface FnCreditsQuote {
+    runs: number;
+    subtotal: string;
+    tax: string;
+    taxLabel: string | null;
+    total: string;
+    currency: string | null;
+}
+/** POST …/credits/purchase → the minted invoice and its charge. Credits land
+ *  when the invoice settles (instantly for a card; later for ACH/BitPay). */
+export interface FnCreditsPurchaseOut {
+    status: string;
+    invoiceId: string;
+    chargeId: string | null;
+    provider: string | null;
+    checkoutUrl: string | null;
+    runs: number;
+    amountUsd: FnMoney;
+    creditBalance: number | null;
+}
+export {};