@scalebrowser/sdk 0.7.0 → 0.8.1

package/CHANGELOG.md

@@ -0,0 +1,53 @@
+# Changelog
+
+The Node/TypeScript SDK for the Scalebrowser daemon.
+
+This file starts at 0.5.0, the oldest release still on npm when it was written
+(2026-09-09). What came before is in the repository's history. It was never
+published as release notes, and reconstructing it here would look like a record
+that had been kept all along.
+
+The daemon and the SDK version independently. An SDK release names the daemon
+version it was tested against wherever that matters.
+
+## 0.8.1 (2026-09-16)
+
+The published `package.json` no longer lists a `smoke` script. It pointed at a
+file outside the package, so it could not run from an installed copy, and
+nothing called it. The library itself is unchanged.
+
+## 0.8.0 (2026-09-11)
+
+Breaking: `host_mode` is gone, and with it the `HostMode` type and the
+`HOST_MODES` list. It named one of two tiers, and there is only one left: a
+daemon runs the engine built for its own operating system, so the tier is the
+host. The field disappears from `Profile`, from `CreateProfileBody` and from a
+preset's `config`. A client that keeps sending it is not refused; the daemon
+ignores the key.
+
+## 0.7.0 (2026-09-09)
+
+- `checkProxy` and the exit-address views report the address KIND (mobile, fixed
+  line, datacenter, unknown) from an ASN dataset instead of the provider's own
+  description. The ownership term for an exit address follows that kind, so a
+  wrong classification used to be off by a factor of 30.
+- A proxy row carries a name and lists the profiles bound to it.
+- The exit-exclusivity rule has a switch, globally and per profile.
+
+## 0.6.0 (2026-09-01)
+
+- Remote access (the MCP tunnel) has a switch. It ships off, and it can only be
+  turned on at the machine itself.
+
+## 0.5.0 (2026-08-31)
+
+- Every profile carries a memory (`PROFILE.md`) and a task list. Both are
+  reachable through the client.
+- `proxy_short_side` in both SDKs.
+- The agent layer says "lease" throughout, matching the names of its tools.
+
+## What this file does not promise
+
+Nothing here promises a stable wire format. The daemon's REST surface is
+versioned under `/v1` and this client tracks it. A breaking change there arrives
+as a major version of the SDK, with the reason written in this file.

package/dist/index.cjs

@@ -1386,6 +1386,23 @@ var ScalebrowserClient = class extends ClientCore {
       signal
     });
   }
+  /**
+   * How many profiles match `params`, split by runtime state. One request, and
+   * its size does not grow with the fleet.
+   *
+   * `listProfiles` is paged and answers a bare array, so counting what came back
+   * counts the page. `listProfileIds` carries the same total but ships an
+   * identifier per profile to do it, and cannot split by state at all.
+   *
+   * `params.state` is ignored here on purpose: a caller labelling every state is
+   * sitting in one of them.
+   */
+  countProfiles(params = {}, signal) {
+    return this.request("GET", "/v1/profiles/count", void 0, {
+      query: { group: params.group, q: params.q },
+      signal
+    });
+  }
   getProfile(id, signal) {
     return this.request("GET", `/v1/profiles/${enc(id)}`, void 0, { signal });
   }
@@ -1716,13 +1733,12 @@ applyMixins(ScalebrowserClient, [
 
 // src/types.ts
 var RUNTIME_STATES = ["stopped", "starting", "running", "crashed"];
-var HOST_MODES = ["linux_engine_spoof", "local_native_windows"];
 var GEO_MODES = ["strict_expected", "follow_exit", "off"];
 var PROXY_KINDS = ["http", "socks5", "gateway"];
 var ROTATIONS = ["sticky", "rotating"];
 
 // src/index.ts
-var VERSION = "0.7.0";
+var VERSION = "0.8.1";
 
 exports.ApiError = ApiError;
 exports.CdpError = CdpError;
@@ -1730,7 +1746,6 @@ exports.CdpSession = CdpSession;
 exports.DEFAULT_CAPACITY = DEFAULT_CAPACITY;
 exports.ErrorCode = ErrorCode;
 exports.GEO_MODES = GEO_MODES;
-exports.HOST_MODES = HOST_MODES;
 exports.NetworkError = NetworkError;
 exports.PROXY_KINDS = PROXY_KINDS;
 exports.ROTATIONS = ROTATIONS;

package/dist/index.d.cts

@@ -81,7 +81,6 @@ interface PersonaMisc {
     get_installed_related_apps: boolean;
     max_touch_points: number;
     pdf_viewer_enabled: boolean;
-    headless_guards: boolean;
 }
 interface Persona {
     os: OsFamily;
@@ -111,7 +110,7 @@ type RecordingState = 'recording' | 'finishing' | 'finished' | 'failed';
 type VideoState = 'queued' | 'rendering' | 'done' | 'failed' | 'cancelled';
 type ExportPresetName = 'web' | 'social' | '4k' | 'editing' | 'gif';
 type AudioStatus = 'ok' | 'silent' | 'off' | 'failed';
-type RenderStage = 'planning' | 'narration' | 'compositing' | 'encoding' | 'finishing';
+type RenderStage = 'planning' | 'narration' | 'compositing' | 'encoding' | 'finishing' | 'extras';
 /** Which files a finished video has. Booleans on purpose, never paths. */
 interface VideoAssets {
     video: boolean;
@@ -159,10 +158,11 @@ type TimestampState = {
     state: 'failed';
     reason: string;
 };
+/** One spoken word and when it is heard in the finished video, in milliseconds from its start. */
 interface TranscriptWord {
     text: string;
-    from_ms: number;
-    to_ms: number;
+    start_ms: number;
+    end_ms: number;
 }
 /** One video row: queued and rendering renders included. */
 interface Video {
@@ -177,7 +177,7 @@ interface Video {
     kind: RecordingKind;
     preset_name: string;
     /** The resolved recipe this video renders (or rendered) under. */
-    preset: unknown;
+    preset: VideoPresetConfig;
     export: ExportPresetName;
     assets: VideoAssets;
     duration_ms: number | null;
@@ -190,7 +190,8 @@ interface Video {
     chapters: Chapter[];
     transcript: TranscriptWord[] | null;
     flags: VideoFlags | null;
-    share: unknown | null;
+    /** The share link of this video ON THIS MACHINE, or nothing shared yet. */
+    share: ShareLinkLocal | null;
     error: string | null;
     created_at: number;
     updated_at: number;
@@ -204,8 +205,11 @@ interface Recording {
     kind: RecordingKind;
     state: RecordingState;
     title: string | null;
+    /** The id of the stored preset the recording was made under, `null` when it named none. */
     preset_id: string | null;
-    preset: unknown;
+    /** That preset's name as it read when the recording started. */
+    preset_name: string | null;
+    preset: VideoPresetConfig;
     manifest_version: number;
     css_width: number;
     css_height: number;
@@ -299,10 +303,14 @@ interface VideoAccessGrant {
 interface VideosStorage {
     recordings_bytes: number;
     videos_bytes: number;
+    /** The main files of the videos this machine still shares. */
     link_bytes: number;
-    link_limit: number;
-    uploads_today: number;
-    uploads_limit: number;
+    /** Known only to the control plane; `null` here. */
+    link_limit: number | null;
+    /** Known only to the control plane; `null` here. */
+    uploads_today: number | null;
+    /** Known only to the control plane; `null` here. */
+    uploads_limit: number | null;
     capacity: {
         recordings_active: number;
         recordings_max: number;
@@ -322,6 +330,18 @@ interface CodecsStatus {
     };
     /** Hardware encoders that passed a real test encode, in preference order. */
     hardware: string[];
+    /** Whether the hardware probe has run. Before it, an empty `hardware` means
+     *  "not asked yet", not "none". */
+    probed: boolean;
+    /** Exports this daemon refuses whatever the order says, with the reason. An
+     *  editor hides them rather than letting a render fail on them. */
+    exports_blocked: BlockedExport[];
+}
+/** One export the daemon refuses, e.g. `4k` while a 3840-wide capture is not
+ *  offered. `reason` starts with its snake code. */
+interface BlockedExport {
+    export: ExportPresetName;
+    reason: string;
 }
 /** What kind of file a media asset is. */
 type MediaKind = 'image' | 'music' | 'subtitle_style';
@@ -380,23 +400,23 @@ interface ShareLinkLocal {
     updated_at: number;
     error: string | null;
 }
+/** `GET /v1/videos/:id/share`: the order, and the link's access code when this
+ *  machine keeps one (sealed at rest). A link the daemon makes for a preset with
+ *  `export.destination.passcode` gets a generated code of ten characters, and
+ *  this is where its owner reads it. `Video.share`, `video_changed` and the
+ *  `video` tool never carry the code. */
+interface ShareStatus extends ShareLinkLocal {
+    /** Absent when this machine keeps no code: the link has none, or its
+     *  revocation is ordered. */
+    code?: string;
+}
 
 /**
- * Wire types: a 1:1 mirror of the daemon's serialized domain model
- * (`crates/core/src/model.rs`, `persona.rs`, `events.rs`) and the endpoint
- * contract in `docs/features/api.md`.
- *
- * THIS IS THE SOURCE, and since 2026-09-09 it is the only one on the TypeScript
- * side: `web-ui/src/api/types.ts` re-exports these files through the
- * `@scalebrowser/wire/*` alias instead of keeping a second copy (Decision 022).
- * Before that the same 160 declarations stood twice, and each header named the
- * other as the truth. The Python SDK
- * (`sdks/python/src/scalebrowser/models*.py`) still carries the shapes by hand,
- * deliberately without a gate; a TS↔pydantic comparator is its own tool.
+ * Wire types: a 1:1 mirror of the daemon's serialized domain model and of the
+ * endpoint contract, and the one source of both on the TypeScript side.
  *
- * These files import nothing but each other, and that is load-bearing rather
- * than tidy: the web-ui pulls them into a BROWSER bundle. A guard in
- * `web-ui/src/test/sdk-type-mirror.test.ts` holds the property.
+ * These files import nothing but each other, which keeps them usable inside a
+ * browser bundle.
  *
  * All Rust enums serialize `snake_case` (serde `rename_all`). Timestamps are
  * unix seconds (`number`, Rust `i64`). The truth for any disagreement is the
@@ -406,9 +426,6 @@ interface ShareLinkLocal {
 /** `RuntimeState` (AC-PR-004). */
 type RuntimeState = 'stopped' | 'starting' | 'running' | 'crashed';
 declare const RUNTIME_STATES: readonly RuntimeState[];
-/** `HostMode` (PRD §B, DEC-004). Default `linux_engine_spoof`. */
-type HostMode = 'linux_engine_spoof' | 'local_native_windows';
-declare const HOST_MODES: readonly HostMode[];
 /** `GeoMode` (AC-PX-002). Default `follow_exit`. */
 type GeoMode = 'strict_expected' | 'follow_exit' | 'off';
 declare const GEO_MODES: readonly GeoMode[];
@@ -443,7 +460,6 @@ interface Profile {
     seed: string;
     engine_version: string;
     persona: Persona;
-    host_mode: HostMode;
     gpu_persona: string | null;
     group_id: string | null;
     proxy_id: string | null;
@@ -485,7 +501,6 @@ interface Group {
 interface PresetConfig {
     /** Pin the batch to one engine build. Omit for per-profile version diversity. */
     engine_version?: string | null;
-    host_mode?: HostMode | null;
     geo_mode?: GeoMode | null;
     /** The geo GATE's expectation, not the persona's drawn region. */
     expected_country?: string | null;
@@ -603,7 +618,8 @@ interface VideoPresetConfig {
         voice: string | null;
         language: string;
         subtitles: 'burned' | 'file' | 'off';
-        subtitle_style: string;
+        /** `custom:<media_id>` names an uploaded font (media kind `subtitle_style`). */
+        subtitle_style: 'classic' | 'word' | `custom:${string}`;
         page_audio: boolean;
         music: MusicBed | null;
     };
@@ -839,8 +855,9 @@ interface SessionImportBody {
 }
 /**
  * Trusted-input payload (`POST /v1/profiles/:id/input`, G8, AC-API-003). Only
- * `action` and `humanize` are fixed by `docs/features/api.md`; the per-action coordinate
- * fields below are the SDK's contract assumption for the daemon's input crate.
+ * `action` and `humanize` are fixed by the API contract; the per-action
+ * coordinate fields below are the SDK's assumption about the daemon's input
+ * layer.
  */
 type TrustedInputBody = {
     action: 'move';
@@ -948,8 +965,7 @@ interface ExitStatus {
 /**
  * The per-profile task list and the profile's own durable memory.
  *
- * One of the files that ARE the contract; the web-ui reads them through
- * `@scalebrowser/wire/*` rather than keeping a copy (Decision 022).
+ * One of the files that are the daemon's wire contract.
  */
 /**
  * Where a task stands.
@@ -1228,13 +1244,6 @@ type StreamedEvent = LifecycleEvent & {
  * the browser `EventSource` cannot do that) and reconnect with backoff. A
  * `/v1/ws` websocket carries the same events; SSE is sufficient for one-way
  * fan-out.
- *
- * Mirrors `web-ui/src/api/events.ts` line for line, deliberately: this package
- * ships to npm and should carry no dependency it does not need, so a shared
- * package would cost more than the copy does. The copy pays for itself with a
- * gate instead: `scripts/verify-mirrored-values.mjs` holds `MAX_BACKOFF_MS` and
- * the backoff line itself against the other side. Two clients of the same daemon
- * that come back at different speeds would be a decision nobody made.
  */
 
 /** Injectable `fetch`; defaults to the global at call time. */
@@ -1278,8 +1287,7 @@ declare function eventStream(params: StreamParams): AsyncIterableIterator<Lifecy
  * What the browser asks (interruptions), the bytes that go in and out
  * (artifacts), and what the licence says (account).
  *
- * One of the files that ARE the contract; the web-ui reads them through
- * `@scalebrowser/wire/*` rather than keeping a copy (Decision 022).
+ * One of the files that are the daemon's wire contract.
  */
 /** What an operator has taken out of an agent's hands. */
 type InterruptionLock = 'always_block' | 'always_allow' | 'agent_decides';
@@ -1542,6 +1550,24 @@ interface ProfileIdsResult {
     count: number;
     ids: string[];
 }
+/**
+ * `GET /v1/profiles/count`: how many profiles match, split by runtime state.
+ *
+ * `total` counts ROWS, so it is the sum of the four states for every state this
+ * daemon can read; a row in a state a newer build introduced counts in `total`
+ * alone rather than being folded into `stopped`.
+ *
+ * The `state` filter is the one this route ignores. A caller labelling all four
+ * scopes is sitting in one of them, so narrowing by it would answer the other
+ * three with zero. Every other filter binds exactly as it does for the listing.
+ */
+interface ProfileCounts {
+    total: number;
+    stopped: number;
+    starting: number;
+    running: number;
+    crashed: number;
+}
 /** `POST /v1/bulk/start`: per-id results plus what the batch as a whole did. */
 interface BulkStartResult {
     results: {
@@ -1566,7 +1592,6 @@ interface ListProfilesParams {
 interface CreateProfileBody {
     name: string;
     seed?: string;
-    host_mode?: HostMode;
     geo_mode?: GeoMode;
     expected_country?: string | null;
     /**
@@ -1588,11 +1613,11 @@ interface CreateProfileBody {
     proxy_id?: string | null;
 }
 /**
- * PATCH, all mutable fields optional. `host_mode` and `seed` are fixed at create
- * time (C4/C5): a DIFFERING `host_mode` is refused with 400, an unchanged echo is
- * accepted. Changing a tier requires delete + recreate.
+ * PATCH, all mutable fields optional. `seed` and `persona_country` are fixed at
+ * create time (C5): they draw the identity, and redrawing it under a profile that
+ * has already been used would be a new identity in an old profile's clothes.
  */
-type UpdateProfileBody = Omit<Partial<CreateProfileBody>, "host_mode" | "seed" | "persona_country"> & {
+type UpdateProfileBody = Omit<Partial<CreateProfileBody>, "seed" | "persona_country"> & {
     /**
      * Turn the exit-address rule off for this profile (DEC-017). Deliberately not
      * part of `CreateProfileBody`: a new profile always claims its address, and
@@ -1790,8 +1815,7 @@ declare class ExtensionsApi extends ClientCore {
  * The account layer: mailboxes, passkeys and the one door a cookie value leaves
  * through.
  *
- * One of the files that ARE the contract; the web-ui reads them through
- * `@scalebrowser/wire/*` rather than keeping a copy (Decision 022). The cookie
+ * One of the files that are the daemon's wire contract. The cookie
  * reveal has no UI counterpart: it is a REST-only route deliberately kept off
  * every screen.
  */
@@ -2196,8 +2220,7 @@ declare class TasksApi extends ClientCore {
  * the live event stream carries them, and the run list describes the same rows.
  * A second copy would let the two drift apart while both looked right.
  *
- * One of the files that ARE the contract; the web-ui reads them through
- * `@scalebrowser/wire/*` rather than keeping a copy (Decision 022).
+ * One of the files that are the daemon's wire contract.
  */
 
 /** Who made the outcome claim. `derived` means nobody did. */
@@ -2317,7 +2340,7 @@ declare class VideosApi extends ClientCore {
      *  whether the link still lives is read from the control plane, not from
      *  here: a number carried along would be wrong the moment another machine
      *  revoked. */
-    shareStatus(videoId: string, signal?: AbortSignal): Promise<ShareLinkLocal>;
+    shareStatus(videoId: string, signal?: AbortSignal): Promise<ShareStatus>;
     /** Revoke the link. The files fall at once; the order stays until the control
      *  plane confirms. */
     revokeShare(videoId: string, signal?: AbortSignal): Promise<void>;
@@ -2549,7 +2572,7 @@ interface Metrics {
  * (shapes), nowhere else.
  */
 
-/** Mirrors `CapacityConfig::default()` (`crates/core/src/config.rs`). */
+/** The daemon's own default capacity limits. */
 declare const DEFAULT_CAPACITY: {
     max_concurrent: number;
     ram_budget_mb: number;
@@ -2577,6 +2600,18 @@ declare class ScalebrowserClient extends ClientCore {
      * page you fetched. Asking for ids costs one request and no persona payloads.
      */
     listProfileIds(params?: ListProfilesParams, signal?: AbortSignal): Promise<ProfileIdsResult>;
+    /**
+     * How many profiles match `params`, split by runtime state. One request, and
+     * its size does not grow with the fleet.
+     *
+     * `listProfiles` is paged and answers a bare array, so counting what came back
+     * counts the page. `listProfileIds` carries the same total but ships an
+     * identifier per profile to do it, and cannot split by state at all.
+     *
+     * `params.state` is ignored here on purpose: a caller labelling every state is
+     * sitting in one of them.
+     */
+    countProfiles(params?: ListProfilesParams, signal?: AbortSignal): Promise<ProfileCounts>;
     getProfile(id: string, signal?: AbortSignal): Promise<Profile>;
     createProfile(body: CreateProfileBody): Promise<Profile>;
     updateProfile(id: string, body: UpdateProfileBody): Promise<Profile>;
@@ -2731,8 +2766,8 @@ interface ScalebrowserClient extends IdentityApi, RunsApi, VideosApi, ControlApi
 }
 
 /**
- * Error model: stable numeric API error codes (SPEC §5,
- * `crates/core/src/error.rs`) and the typed exceptions the SDK throws.
+ * Error model: the stable numeric API error codes and the typed exceptions
+ * the SDK throws.
  */
 /** Stable numeric API error codes (4001–4013, append-only: a retired code stays
  * reserved rather than being reused). */
@@ -2769,7 +2804,7 @@ declare const ErrorCode: {
     readonly ExitAddressTaken: 4013;
 };
 type ErrorCodeValue = (typeof ErrorCode)[keyof typeof ErrorCode];
-/** Error body shape: `{ code, message }` (docs/features/api.md). */
+/** Error body shape: `{ code, message }`. */
 interface ApiErrorBody {
     code?: number;
     message?: string;
@@ -2824,6 +2859,6 @@ declare function errorMessage(err: unknown): string;
  * ```
  */
 
-declare const VERSION = "0.7.0";
+declare const VERSION = "0.8.1";
 
-export { type Account, type ActivitySnapshot, type AgentRun, ApiError, type ApiErrorBody, type ArtifactBytes, type ArtifactPutResult, type AttachOptions, type AudioStatus, type AuditDetectorReport, type AuditReport, type AuditStatus, type AuditVerdict, type BindInboxBody, type CdpConnectOptions, CdpError, type CdpEvent, CdpSession, type Chapter, type ClickOptions, type CodecsStatus, type Connection, type CreateGroupBody, type CreateInboxBody, type CreatePresetBody, type CreateTasksBody, type CreateTasksResult, DEFAULT_CAPACITY, type DeleteInterruptionRuleParams, type EffectiveInterruptionLock, ErrorCode, type ErrorCodeValue, type EvaluateOptions, type ExitClaim, type ExitRuleStatus, type ExitScope, type ExitStatus, type ExportPresetName, type ExtraOutput, type FetchLike, GEO_MODES, type GeoMode, type GoalSource, type Group, HOST_MODES, type HealthStatus, type HostMode, type Inbox, type InboxBinding, type InboxBindings, type InboxChannel, type InputClient, type InterruptionChoice, type InterruptionLock, type InterruptionLockRow, type InterruptionLockView, type InterruptionRuleRow, type LaunchHandle, type ListRunsParams, type ListStepsParams, type ListTasksParams, type ListVideosParams, type MediaAsset, type MediaKind, type MusicBed, type NarrationLine, type NavigateOptions, NetworkError, type OsFamily, type OutcomeSource, PROXY_KINDS, type PasskeyRow, type PatchTaskBody, type PersonaConstraintOptions, type Preset, type PresetConfig, type PresetConstraints, type PreviewHidden, type PreviewMoment, type Profile, type ProfileActivity, type ProfileMemory, type ProfileTask, type ProtectionLevel, type ProtectionStatus, type Proxy, type ProxyKind, type ProxyRow, type ProxyUsage, ROTATIONS, RUNTIME_STATES, type ReadyStatus, type Recording, type RecordingKind, type RecordingState, type RemoteStatus, type RenderProgress, type RenderRequestBody, type RenderStage, type RevealCookiesBody, type RevealCookiesResult, type RevealedCookie, type Rotation, type RunActor, type RunOutcome, type RunStep, type RuntimeState, ScalebrowserClient, type ScalebrowserClientOptions, ScalebrowserError, type ScrollOptions, type SecretBindingMode, type SecretDeleteResult, type SecretKind, type SecretListResult, type SecretOrigin, type SecretPatchBody, type SecretRow, type SecretRunBody, type SecretRunMention, type SecretRunResult, type SecretScrubResult, type SecretState, type SessionExportBody, type SessionExportResult, type SessionImportBody, type SessionKind, type SetInterruptionLockBody, type SetInterruptionRuleBody, type ShareLinkLocal, type ShotFocus, type ShotIntent, type StepKind, type StepTarget, type StreamHandlers, type StreamParams, type StreamStatus, type TaskState, type TimestampState, type TranscriptWord, type TrustedInputBody, type TtsProviderView, type TtsVerifyResult, type UpdateGroupBody, type UpdateInboxBody, type UpdatePresetBody, VERSION, type Video, type VideoAccessGrant, type VideoAssetName, type VideoAssets, type VideoBackground, type VideoCard, type VideoDestination, type VideoFlags, type VideoPreset, type VideoPresetClip, type VideoPresetClipBody, type VideoPresetClipProgress, type VideoPresetClipStarted, type VideoPresetConfig, type VideoPresetPreview, type VideoPresetPreviewBody, type VideoState, type VideosPage, type VideosStorage, type WriteMemoryBody, deriveMetricsFromProfiles, errorMessage, eventStream, openCdpSession, parseSseFrame, subscribeEvents };
+export { type Account, type ActivitySnapshot, type AgentRun, ApiError, type ApiErrorBody, type ArtifactBytes, type ArtifactPutResult, type AttachOptions, type AudioStatus, type AuditDetectorReport, type AuditReport, type AuditStatus, type AuditVerdict, type BindInboxBody, type BlockedExport, type CdpConnectOptions, CdpError, type CdpEvent, CdpSession, type Chapter, type ClickOptions, type CodecsStatus, type Connection, type CreateGroupBody, type CreateInboxBody, type CreatePresetBody, type CreateTasksBody, type CreateTasksResult, DEFAULT_CAPACITY, type DeleteInterruptionRuleParams, type EffectiveInterruptionLock, ErrorCode, type ErrorCodeValue, type EvaluateOptions, type ExitClaim, type ExitRuleStatus, type ExitScope, type ExitStatus, type ExportPresetName, type ExtraOutput, type FetchLike, GEO_MODES, type GeoMode, type GoalSource, type Group, type HealthStatus, type Inbox, type InboxBinding, type InboxBindings, type InboxChannel, type InputClient, type InterruptionChoice, type InterruptionLock, type InterruptionLockRow, type InterruptionLockView, type InterruptionRuleRow, type LaunchHandle, type ListRunsParams, type ListStepsParams, type ListTasksParams, type ListVideosParams, type MediaAsset, type MediaKind, type MusicBed, type NarrationLine, type NavigateOptions, NetworkError, type OsFamily, type OutcomeSource, PROXY_KINDS, type PasskeyRow, type PatchTaskBody, type PersonaConstraintOptions, type Preset, type PresetConfig, type PresetConstraints, type PreviewHidden, type PreviewMoment, type Profile, type ProfileActivity, type ProfileMemory, type ProfileTask, type ProtectionLevel, type ProtectionStatus, type Proxy, type ProxyKind, type ProxyRow, type ProxyUsage, ROTATIONS, RUNTIME_STATES, type ReadyStatus, type Recording, type RecordingKind, type RecordingState, type RemoteStatus, type RenderProgress, type RenderRequestBody, type RenderStage, type RevealCookiesBody, type RevealCookiesResult, type RevealedCookie, type Rotation, type RunActor, type RunOutcome, type RunStep, type RuntimeState, ScalebrowserClient, type ScalebrowserClientOptions, ScalebrowserError, type ScrollOptions, type SecretBindingMode, type SecretDeleteResult, type SecretKind, type SecretListResult, type SecretOrigin, type SecretPatchBody, type SecretRow, type SecretRunBody, type SecretRunMention, type SecretRunResult, type SecretScrubResult, type SecretState, type SessionExportBody, type SessionExportResult, type SessionImportBody, type SessionKind, type SetInterruptionLockBody, type SetInterruptionRuleBody, type ShareLinkLocal, type ShareStatus, type ShotFocus, type ShotIntent, type StepKind, type StepTarget, type StreamHandlers, type StreamParams, type StreamStatus, type TaskState, type TimestampState, type TranscriptWord, type TrustedInputBody, type TtsProviderView, type TtsVerifyResult, type UpdateGroupBody, type UpdateInboxBody, type UpdatePresetBody, VERSION, type Video, type VideoAccessGrant, type VideoAssetName, type VideoAssets, type VideoBackground, type VideoCard, type VideoDestination, type VideoFlags, type VideoPreset, type VideoPresetClip, type VideoPresetClipBody, type VideoPresetClipProgress, type VideoPresetClipStarted, type VideoPresetConfig, type VideoPresetPreview, type VideoPresetPreviewBody, type VideoState, type VideosPage, type VideosStorage, type WriteMemoryBody, deriveMetricsFromProfiles, errorMessage, eventStream, openCdpSession, parseSseFrame, subscribeEvents };

package/dist/index.d.ts

@@ -81,7 +81,6 @@ interface PersonaMisc {
     get_installed_related_apps: boolean;
     max_touch_points: number;
     pdf_viewer_enabled: boolean;
-    headless_guards: boolean;
 }
 interface Persona {
     os: OsFamily;
@@ -111,7 +110,7 @@ type RecordingState = 'recording' | 'finishing' | 'finished' | 'failed';
 type VideoState = 'queued' | 'rendering' | 'done' | 'failed' | 'cancelled';
 type ExportPresetName = 'web' | 'social' | '4k' | 'editing' | 'gif';
 type AudioStatus = 'ok' | 'silent' | 'off' | 'failed';
-type RenderStage = 'planning' | 'narration' | 'compositing' | 'encoding' | 'finishing';
+type RenderStage = 'planning' | 'narration' | 'compositing' | 'encoding' | 'finishing' | 'extras';
 /** Which files a finished video has. Booleans on purpose, never paths. */
 interface VideoAssets {
     video: boolean;
@@ -159,10 +158,11 @@ type TimestampState = {
     state: 'failed';
     reason: string;
 };
+/** One spoken word and when it is heard in the finished video, in milliseconds from its start. */
 interface TranscriptWord {
     text: string;
-    from_ms: number;
-    to_ms: number;
+    start_ms: number;
+    end_ms: number;
 }
 /** One video row: queued and rendering renders included. */
 interface Video {
@@ -177,7 +177,7 @@ interface Video {
     kind: RecordingKind;
     preset_name: string;
     /** The resolved recipe this video renders (or rendered) under. */
-    preset: unknown;
+    preset: VideoPresetConfig;
     export: ExportPresetName;
     assets: VideoAssets;
     duration_ms: number | null;
@@ -190,7 +190,8 @@ interface Video {
     chapters: Chapter[];
     transcript: TranscriptWord[] | null;
     flags: VideoFlags | null;
-    share: unknown | null;
+    /** The share link of this video ON THIS MACHINE, or nothing shared yet. */
+    share: ShareLinkLocal | null;
     error: string | null;
     created_at: number;
     updated_at: number;
@@ -204,8 +205,11 @@ interface Recording {
     kind: RecordingKind;
     state: RecordingState;
     title: string | null;
+    /** The id of the stored preset the recording was made under, `null` when it named none. */
     preset_id: string | null;
-    preset: unknown;
+    /** That preset's name as it read when the recording started. */
+    preset_name: string | null;
+    preset: VideoPresetConfig;
     manifest_version: number;
     css_width: number;
     css_height: number;
@@ -299,10 +303,14 @@ interface VideoAccessGrant {
 interface VideosStorage {
     recordings_bytes: number;
     videos_bytes: number;
+    /** The main files of the videos this machine still shares. */
     link_bytes: number;
-    link_limit: number;
-    uploads_today: number;
-    uploads_limit: number;
+    /** Known only to the control plane; `null` here. */
+    link_limit: number | null;
+    /** Known only to the control plane; `null` here. */
+    uploads_today: number | null;
+    /** Known only to the control plane; `null` here. */
+    uploads_limit: number | null;
     capacity: {
         recordings_active: number;
         recordings_max: number;
@@ -322,6 +330,18 @@ interface CodecsStatus {
     };
     /** Hardware encoders that passed a real test encode, in preference order. */
     hardware: string[];
+    /** Whether the hardware probe has run. Before it, an empty `hardware` means
+     *  "not asked yet", not "none". */
+    probed: boolean;
+    /** Exports this daemon refuses whatever the order says, with the reason. An
+     *  editor hides them rather than letting a render fail on them. */
+    exports_blocked: BlockedExport[];
+}
+/** One export the daemon refuses, e.g. `4k` while a 3840-wide capture is not
+ *  offered. `reason` starts with its snake code. */
+interface BlockedExport {
+    export: ExportPresetName;
+    reason: string;
 }
 /** What kind of file a media asset is. */
 type MediaKind = 'image' | 'music' | 'subtitle_style';
@@ -380,23 +400,23 @@ interface ShareLinkLocal {
     updated_at: number;
     error: string | null;
 }
+/** `GET /v1/videos/:id/share`: the order, and the link's access code when this
+ *  machine keeps one (sealed at rest). A link the daemon makes for a preset with
+ *  `export.destination.passcode` gets a generated code of ten characters, and
+ *  this is where its owner reads it. `Video.share`, `video_changed` and the
+ *  `video` tool never carry the code. */
+interface ShareStatus extends ShareLinkLocal {
+    /** Absent when this machine keeps no code: the link has none, or its
+     *  revocation is ordered. */
+    code?: string;
+}
 
 /**
- * Wire types: a 1:1 mirror of the daemon's serialized domain model
- * (`crates/core/src/model.rs`, `persona.rs`, `events.rs`) and the endpoint
- * contract in `docs/features/api.md`.
- *
- * THIS IS THE SOURCE, and since 2026-09-09 it is the only one on the TypeScript
- * side: `web-ui/src/api/types.ts` re-exports these files through the
- * `@scalebrowser/wire/*` alias instead of keeping a second copy (Decision 022).
- * Before that the same 160 declarations stood twice, and each header named the
- * other as the truth. The Python SDK
- * (`sdks/python/src/scalebrowser/models*.py`) still carries the shapes by hand,
- * deliberately without a gate; a TS↔pydantic comparator is its own tool.
+ * Wire types: a 1:1 mirror of the daemon's serialized domain model and of the
+ * endpoint contract, and the one source of both on the TypeScript side.
  *
- * These files import nothing but each other, and that is load-bearing rather
- * than tidy: the web-ui pulls them into a BROWSER bundle. A guard in
- * `web-ui/src/test/sdk-type-mirror.test.ts` holds the property.
+ * These files import nothing but each other, which keeps them usable inside a
+ * browser bundle.
  *
  * All Rust enums serialize `snake_case` (serde `rename_all`). Timestamps are
  * unix seconds (`number`, Rust `i64`). The truth for any disagreement is the
@@ -406,9 +426,6 @@ interface ShareLinkLocal {
 /** `RuntimeState` (AC-PR-004). */
 type RuntimeState = 'stopped' | 'starting' | 'running' | 'crashed';
 declare const RUNTIME_STATES: readonly RuntimeState[];
-/** `HostMode` (PRD §B, DEC-004). Default `linux_engine_spoof`. */
-type HostMode = 'linux_engine_spoof' | 'local_native_windows';
-declare const HOST_MODES: readonly HostMode[];
 /** `GeoMode` (AC-PX-002). Default `follow_exit`. */
 type GeoMode = 'strict_expected' | 'follow_exit' | 'off';
 declare const GEO_MODES: readonly GeoMode[];
@@ -443,7 +460,6 @@ interface Profile {
     seed: string;
     engine_version: string;
     persona: Persona;
-    host_mode: HostMode;
     gpu_persona: string | null;
     group_id: string | null;
     proxy_id: string | null;
@@ -485,7 +501,6 @@ interface Group {
 interface PresetConfig {
     /** Pin the batch to one engine build. Omit for per-profile version diversity. */
     engine_version?: string | null;
-    host_mode?: HostMode | null;
     geo_mode?: GeoMode | null;
     /** The geo GATE's expectation, not the persona's drawn region. */
     expected_country?: string | null;
@@ -603,7 +618,8 @@ interface VideoPresetConfig {
         voice: string | null;
         language: string;
         subtitles: 'burned' | 'file' | 'off';
-        subtitle_style: string;
+        /** `custom:<media_id>` names an uploaded font (media kind `subtitle_style`). */
+        subtitle_style: 'classic' | 'word' | `custom:${string}`;
         page_audio: boolean;
         music: MusicBed | null;
     };
@@ -839,8 +855,9 @@ interface SessionImportBody {
 }
 /**
  * Trusted-input payload (`POST /v1/profiles/:id/input`, G8, AC-API-003). Only
- * `action` and `humanize` are fixed by `docs/features/api.md`; the per-action coordinate
- * fields below are the SDK's contract assumption for the daemon's input crate.
+ * `action` and `humanize` are fixed by the API contract; the per-action
+ * coordinate fields below are the SDK's assumption about the daemon's input
+ * layer.
  */
 type TrustedInputBody = {
     action: 'move';
@@ -948,8 +965,7 @@ interface ExitStatus {
 /**
  * The per-profile task list and the profile's own durable memory.
  *
- * One of the files that ARE the contract; the web-ui reads them through
- * `@scalebrowser/wire/*` rather than keeping a copy (Decision 022).
+ * One of the files that are the daemon's wire contract.
  */
 /**
  * Where a task stands.
@@ -1228,13 +1244,6 @@ type StreamedEvent = LifecycleEvent & {
  * the browser `EventSource` cannot do that) and reconnect with backoff. A
  * `/v1/ws` websocket carries the same events; SSE is sufficient for one-way
  * fan-out.
- *
- * Mirrors `web-ui/src/api/events.ts` line for line, deliberately: this package
- * ships to npm and should carry no dependency it does not need, so a shared
- * package would cost more than the copy does. The copy pays for itself with a
- * gate instead: `scripts/verify-mirrored-values.mjs` holds `MAX_BACKOFF_MS` and
- * the backoff line itself against the other side. Two clients of the same daemon
- * that come back at different speeds would be a decision nobody made.
  */
 
 /** Injectable `fetch`; defaults to the global at call time. */
@@ -1278,8 +1287,7 @@ declare function eventStream(params: StreamParams): AsyncIterableIterator<Lifecy
  * What the browser asks (interruptions), the bytes that go in and out
  * (artifacts), and what the licence says (account).
  *
- * One of the files that ARE the contract; the web-ui reads them through
- * `@scalebrowser/wire/*` rather than keeping a copy (Decision 022).
+ * One of the files that are the daemon's wire contract.
  */
 /** What an operator has taken out of an agent's hands. */
 type InterruptionLock = 'always_block' | 'always_allow' | 'agent_decides';
@@ -1542,6 +1550,24 @@ interface ProfileIdsResult {
     count: number;
     ids: string[];
 }
+/**
+ * `GET /v1/profiles/count`: how many profiles match, split by runtime state.
+ *
+ * `total` counts ROWS, so it is the sum of the four states for every state this
+ * daemon can read; a row in a state a newer build introduced counts in `total`
+ * alone rather than being folded into `stopped`.
+ *
+ * The `state` filter is the one this route ignores. A caller labelling all four
+ * scopes is sitting in one of them, so narrowing by it would answer the other
+ * three with zero. Every other filter binds exactly as it does for the listing.
+ */
+interface ProfileCounts {
+    total: number;
+    stopped: number;
+    starting: number;
+    running: number;
+    crashed: number;
+}
 /** `POST /v1/bulk/start`: per-id results plus what the batch as a whole did. */
 interface BulkStartResult {
     results: {
@@ -1566,7 +1592,6 @@ interface ListProfilesParams {
 interface CreateProfileBody {
     name: string;
     seed?: string;
-    host_mode?: HostMode;
     geo_mode?: GeoMode;
     expected_country?: string | null;
     /**
@@ -1588,11 +1613,11 @@ interface CreateProfileBody {
     proxy_id?: string | null;
 }
 /**
- * PATCH, all mutable fields optional. `host_mode` and `seed` are fixed at create
- * time (C4/C5): a DIFFERING `host_mode` is refused with 400, an unchanged echo is
- * accepted. Changing a tier requires delete + recreate.
+ * PATCH, all mutable fields optional. `seed` and `persona_country` are fixed at
+ * create time (C5): they draw the identity, and redrawing it under a profile that
+ * has already been used would be a new identity in an old profile's clothes.
  */
-type UpdateProfileBody = Omit<Partial<CreateProfileBody>, "host_mode" | "seed" | "persona_country"> & {
+type UpdateProfileBody = Omit<Partial<CreateProfileBody>, "seed" | "persona_country"> & {
     /**
      * Turn the exit-address rule off for this profile (DEC-017). Deliberately not
      * part of `CreateProfileBody`: a new profile always claims its address, and
@@ -1790,8 +1815,7 @@ declare class ExtensionsApi extends ClientCore {
  * The account layer: mailboxes, passkeys and the one door a cookie value leaves
  * through.
  *
- * One of the files that ARE the contract; the web-ui reads them through
- * `@scalebrowser/wire/*` rather than keeping a copy (Decision 022). The cookie
+ * One of the files that are the daemon's wire contract. The cookie
  * reveal has no UI counterpart: it is a REST-only route deliberately kept off
  * every screen.
  */
@@ -2196,8 +2220,7 @@ declare class TasksApi extends ClientCore {
  * the live event stream carries them, and the run list describes the same rows.
  * A second copy would let the two drift apart while both looked right.
  *
- * One of the files that ARE the contract; the web-ui reads them through
- * `@scalebrowser/wire/*` rather than keeping a copy (Decision 022).
+ * One of the files that are the daemon's wire contract.
  */
 
 /** Who made the outcome claim. `derived` means nobody did. */
@@ -2317,7 +2340,7 @@ declare class VideosApi extends ClientCore {
      *  whether the link still lives is read from the control plane, not from
      *  here: a number carried along would be wrong the moment another machine
      *  revoked. */
-    shareStatus(videoId: string, signal?: AbortSignal): Promise<ShareLinkLocal>;
+    shareStatus(videoId: string, signal?: AbortSignal): Promise<ShareStatus>;
     /** Revoke the link. The files fall at once; the order stays until the control
      *  plane confirms. */
     revokeShare(videoId: string, signal?: AbortSignal): Promise<void>;
@@ -2549,7 +2572,7 @@ interface Metrics {
  * (shapes), nowhere else.
  */
 
-/** Mirrors `CapacityConfig::default()` (`crates/core/src/config.rs`). */
+/** The daemon's own default capacity limits. */
 declare const DEFAULT_CAPACITY: {
     max_concurrent: number;
     ram_budget_mb: number;
@@ -2577,6 +2600,18 @@ declare class ScalebrowserClient extends ClientCore {
      * page you fetched. Asking for ids costs one request and no persona payloads.
      */
     listProfileIds(params?: ListProfilesParams, signal?: AbortSignal): Promise<ProfileIdsResult>;
+    /**
+     * How many profiles match `params`, split by runtime state. One request, and
+     * its size does not grow with the fleet.
+     *
+     * `listProfiles` is paged and answers a bare array, so counting what came back
+     * counts the page. `listProfileIds` carries the same total but ships an
+     * identifier per profile to do it, and cannot split by state at all.
+     *
+     * `params.state` is ignored here on purpose: a caller labelling every state is
+     * sitting in one of them.
+     */
+    countProfiles(params?: ListProfilesParams, signal?: AbortSignal): Promise<ProfileCounts>;
     getProfile(id: string, signal?: AbortSignal): Promise<Profile>;
     createProfile(body: CreateProfileBody): Promise<Profile>;
     updateProfile(id: string, body: UpdateProfileBody): Promise<Profile>;
@@ -2731,8 +2766,8 @@ interface ScalebrowserClient extends IdentityApi, RunsApi, VideosApi, ControlApi
 }
 
 /**
- * Error model: stable numeric API error codes (SPEC §5,
- * `crates/core/src/error.rs`) and the typed exceptions the SDK throws.
+ * Error model: the stable numeric API error codes and the typed exceptions
+ * the SDK throws.
  */
 /** Stable numeric API error codes (4001–4013, append-only: a retired code stays
  * reserved rather than being reused). */
@@ -2769,7 +2804,7 @@ declare const ErrorCode: {
     readonly ExitAddressTaken: 4013;
 };
 type ErrorCodeValue = (typeof ErrorCode)[keyof typeof ErrorCode];
-/** Error body shape: `{ code, message }` (docs/features/api.md). */
+/** Error body shape: `{ code, message }`. */
 interface ApiErrorBody {
     code?: number;
     message?: string;
@@ -2824,6 +2859,6 @@ declare function errorMessage(err: unknown): string;
  * ```
  */
 
-declare const VERSION = "0.7.0";
+declare const VERSION = "0.8.1";
 
-export { type Account, type ActivitySnapshot, type AgentRun, ApiError, type ApiErrorBody, type ArtifactBytes, type ArtifactPutResult, type AttachOptions, type AudioStatus, type AuditDetectorReport, type AuditReport, type AuditStatus, type AuditVerdict, type BindInboxBody, type CdpConnectOptions, CdpError, type CdpEvent, CdpSession, type Chapter, type ClickOptions, type CodecsStatus, type Connection, type CreateGroupBody, type CreateInboxBody, type CreatePresetBody, type CreateTasksBody, type CreateTasksResult, DEFAULT_CAPACITY, type DeleteInterruptionRuleParams, type EffectiveInterruptionLock, ErrorCode, type ErrorCodeValue, type EvaluateOptions, type ExitClaim, type ExitRuleStatus, type ExitScope, type ExitStatus, type ExportPresetName, type ExtraOutput, type FetchLike, GEO_MODES, type GeoMode, type GoalSource, type Group, HOST_MODES, type HealthStatus, type HostMode, type Inbox, type InboxBinding, type InboxBindings, type InboxChannel, type InputClient, type InterruptionChoice, type InterruptionLock, type InterruptionLockRow, type InterruptionLockView, type InterruptionRuleRow, type LaunchHandle, type ListRunsParams, type ListStepsParams, type ListTasksParams, type ListVideosParams, type MediaAsset, type MediaKind, type MusicBed, type NarrationLine, type NavigateOptions, NetworkError, type OsFamily, type OutcomeSource, PROXY_KINDS, type PasskeyRow, type PatchTaskBody, type PersonaConstraintOptions, type Preset, type PresetConfig, type PresetConstraints, type PreviewHidden, type PreviewMoment, type Profile, type ProfileActivity, type ProfileMemory, type ProfileTask, type ProtectionLevel, type ProtectionStatus, type Proxy, type ProxyKind, type ProxyRow, type ProxyUsage, ROTATIONS, RUNTIME_STATES, type ReadyStatus, type Recording, type RecordingKind, type RecordingState, type RemoteStatus, type RenderProgress, type RenderRequestBody, type RenderStage, type RevealCookiesBody, type RevealCookiesResult, type RevealedCookie, type Rotation, type RunActor, type RunOutcome, type RunStep, type RuntimeState, ScalebrowserClient, type ScalebrowserClientOptions, ScalebrowserError, type ScrollOptions, type SecretBindingMode, type SecretDeleteResult, type SecretKind, type SecretListResult, type SecretOrigin, type SecretPatchBody, type SecretRow, type SecretRunBody, type SecretRunMention, type SecretRunResult, type SecretScrubResult, type SecretState, type SessionExportBody, type SessionExportResult, type SessionImportBody, type SessionKind, type SetInterruptionLockBody, type SetInterruptionRuleBody, type ShareLinkLocal, type ShotFocus, type ShotIntent, type StepKind, type StepTarget, type StreamHandlers, type StreamParams, type StreamStatus, type TaskState, type TimestampState, type TranscriptWord, type TrustedInputBody, type TtsProviderView, type TtsVerifyResult, type UpdateGroupBody, type UpdateInboxBody, type UpdatePresetBody, VERSION, type Video, type VideoAccessGrant, type VideoAssetName, type VideoAssets, type VideoBackground, type VideoCard, type VideoDestination, type VideoFlags, type VideoPreset, type VideoPresetClip, type VideoPresetClipBody, type VideoPresetClipProgress, type VideoPresetClipStarted, type VideoPresetConfig, type VideoPresetPreview, type VideoPresetPreviewBody, type VideoState, type VideosPage, type VideosStorage, type WriteMemoryBody, deriveMetricsFromProfiles, errorMessage, eventStream, openCdpSession, parseSseFrame, subscribeEvents };
+export { type Account, type ActivitySnapshot, type AgentRun, ApiError, type ApiErrorBody, type ArtifactBytes, type ArtifactPutResult, type AttachOptions, type AudioStatus, type AuditDetectorReport, type AuditReport, type AuditStatus, type AuditVerdict, type BindInboxBody, type BlockedExport, type CdpConnectOptions, CdpError, type CdpEvent, CdpSession, type Chapter, type ClickOptions, type CodecsStatus, type Connection, type CreateGroupBody, type CreateInboxBody, type CreatePresetBody, type CreateTasksBody, type CreateTasksResult, DEFAULT_CAPACITY, type DeleteInterruptionRuleParams, type EffectiveInterruptionLock, ErrorCode, type ErrorCodeValue, type EvaluateOptions, type ExitClaim, type ExitRuleStatus, type ExitScope, type ExitStatus, type ExportPresetName, type ExtraOutput, type FetchLike, GEO_MODES, type GeoMode, type GoalSource, type Group, type HealthStatus, type Inbox, type InboxBinding, type InboxBindings, type InboxChannel, type InputClient, type InterruptionChoice, type InterruptionLock, type InterruptionLockRow, type InterruptionLockView, type InterruptionRuleRow, type LaunchHandle, type ListRunsParams, type ListStepsParams, type ListTasksParams, type ListVideosParams, type MediaAsset, type MediaKind, type MusicBed, type NarrationLine, type NavigateOptions, NetworkError, type OsFamily, type OutcomeSource, PROXY_KINDS, type PasskeyRow, type PatchTaskBody, type PersonaConstraintOptions, type Preset, type PresetConfig, type PresetConstraints, type PreviewHidden, type PreviewMoment, type Profile, type ProfileActivity, type ProfileMemory, type ProfileTask, type ProtectionLevel, type ProtectionStatus, type Proxy, type ProxyKind, type ProxyRow, type ProxyUsage, ROTATIONS, RUNTIME_STATES, type ReadyStatus, type Recording, type RecordingKind, type RecordingState, type RemoteStatus, type RenderProgress, type RenderRequestBody, type RenderStage, type RevealCookiesBody, type RevealCookiesResult, type RevealedCookie, type Rotation, type RunActor, type RunOutcome, type RunStep, type RuntimeState, ScalebrowserClient, type ScalebrowserClientOptions, ScalebrowserError, type ScrollOptions, type SecretBindingMode, type SecretDeleteResult, type SecretKind, type SecretListResult, type SecretOrigin, type SecretPatchBody, type SecretRow, type SecretRunBody, type SecretRunMention, type SecretRunResult, type SecretScrubResult, type SecretState, type SessionExportBody, type SessionExportResult, type SessionImportBody, type SessionKind, type SetInterruptionLockBody, type SetInterruptionRuleBody, type ShareLinkLocal, type ShareStatus, type ShotFocus, type ShotIntent, type StepKind, type StepTarget, type StreamHandlers, type StreamParams, type StreamStatus, type TaskState, type TimestampState, type TranscriptWord, type TrustedInputBody, type TtsProviderView, type TtsVerifyResult, type UpdateGroupBody, type UpdateInboxBody, type UpdatePresetBody, VERSION, type Video, type VideoAccessGrant, type VideoAssetName, type VideoAssets, type VideoBackground, type VideoCard, type VideoDestination, type VideoFlags, type VideoPreset, type VideoPresetClip, type VideoPresetClipBody, type VideoPresetClipProgress, type VideoPresetClipStarted, type VideoPresetConfig, type VideoPresetPreview, type VideoPresetPreviewBody, type VideoState, type VideosPage, type VideosStorage, type WriteMemoryBody, deriveMetricsFromProfiles, errorMessage, eventStream, openCdpSession, parseSseFrame, subscribeEvents };

package/dist/index.js

@@ -1380,6 +1380,23 @@ var ScalebrowserClient = class extends ClientCore {
       signal
     });
   }
+  /**
+   * How many profiles match `params`, split by runtime state. One request, and
+   * its size does not grow with the fleet.
+   *
+   * `listProfiles` is paged and answers a bare array, so counting what came back
+   * counts the page. `listProfileIds` carries the same total but ships an
+   * identifier per profile to do it, and cannot split by state at all.
+   *
+   * `params.state` is ignored here on purpose: a caller labelling every state is
+   * sitting in one of them.
+   */
+  countProfiles(params = {}, signal) {
+    return this.request("GET", "/v1/profiles/count", void 0, {
+      query: { group: params.group, q: params.q },
+      signal
+    });
+  }
   getProfile(id, signal) {
     return this.request("GET", `/v1/profiles/${enc(id)}`, void 0, { signal });
   }
@@ -1710,12 +1727,11 @@ applyMixins(ScalebrowserClient, [
 
 // src/types.ts
 var RUNTIME_STATES = ["stopped", "starting", "running", "crashed"];
-var HOST_MODES = ["linux_engine_spoof", "local_native_windows"];
 var GEO_MODES = ["strict_expected", "follow_exit", "off"];
 var PROXY_KINDS = ["http", "socks5", "gateway"];
 var ROTATIONS = ["sticky", "rotating"];
 
 // src/index.ts
-var VERSION = "0.7.0";
+var VERSION = "0.8.1";
 
-export { ApiError, CdpError, CdpSession, DEFAULT_CAPACITY, ErrorCode, GEO_MODES, HOST_MODES, NetworkError, PROXY_KINDS, ROTATIONS, RUNTIME_STATES, ScalebrowserClient, ScalebrowserError, VERSION, deriveMetricsFromProfiles, errorMessage, eventStream, openCdpSession, parseSseFrame, subscribeEvents };
+export { ApiError, CdpError, CdpSession, DEFAULT_CAPACITY, ErrorCode, GEO_MODES, NetworkError, PROXY_KINDS, ROTATIONS, RUNTIME_STATES, ScalebrowserClient, ScalebrowserError, VERSION, deriveMetricsFromProfiles, errorMessage, eventStream, openCdpSession, parseSseFrame, subscribeEvents };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@scalebrowser/sdk",
-  "version": "0.7.0",
-  "description": "Official Node/TypeScript SDK for the Scalebrowser daemon — typed REST client + direct-CDP driver plane (nodriver-style, not Playwright).",
+  "version": "0.8.1",
+  "description": "Official Node/TypeScript SDK for the Scalebrowser daemon: typed REST client plus a direct-CDP driver plane (nodriver-style, not Playwright).",
   "type": "module",
   "license": "MIT",
   "homepage": "https://scalebrowser.net",
@@ -36,6 +36,7 @@
   },
   "files": [
     "dist",
+    "CHANGELOG.md",
     "README.md",
     "LICENSE"
   ],
@@ -45,7 +46,6 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "prepare": "npm run build",
-    "smoke": "node ../scripts/smoke-node.mjs",
     "lint": "eslint src test examples",
     "test:coverage": "vitest run --coverage"
   },