@desplega.ai/agent-swarm 2.3.0 → 2.4.1

package/src/telemetry-contract/types.gen.ts

@@ -49,6 +49,147 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/used-by": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Record a "used by" logo consent change
+         * @description Stores one grant or revoke of an install's consent to show its org's logo
+         *     on agent-swarm.dev, then posts it to the feedback Slack channel. Nothing is
+         *     published automatically: a human approves each logo by hand. Called
+         *     server-to-server by the agent-swarm API; there is no read endpoint. The
+         *     JSON body must not exceed 4 KB.
+         */
+        post: operations["submitUsedByConsent"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/logo": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Fetch an org logo by website hostname
+         * @description Returns a 128 px PNG logo for `domain`, fetched from logo.dev with a key held
+         *     only by this service, so dashboards (self-hosted included) can show their
+         *     org's logo without the key reaching their config or UI bundle. Unknown
+         *     domains get logo.dev's generated monogram. Answers are cached in memory for a
+         *     day (a 404 for an hour), and browsers may cache the image for a day. Rate
+         *     limited per IP: a burst of 60, then one per second.
+         */
+        get: operations["getOrgLogo"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/fleet/benchmarks": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Fleet percentiles for tasks per week and task success rate
+         * @description Percentiles over production agent-swarm installs with at least 10 finished
+         *     tasks in the last 30 days, overall and by agent count (`1`, `2-5`, `6+`).
+         *     Internal, QA, test and E2B installs are excluded. Aggregates only: no install
+         *     ID or org name. Whole-fleet buckets require 20 installs. Optional profile
+         *     filters select orgs by their latest API server or UI context. Both filters
+         *     must be present. A peer group requires 20 contributing orgs. Smaller groups fall back to the whole fleet with
+         *     `peer_group: null`. Peer buckets also require 20 distinct orgs. Recomputed hourly from `raw_events`; the request carries no install
+         *     ID. Called server to server by agent-swarm API servers, so the response sends
+         *     no CORS headers. Rate limited per IP: a burst of 10, then 10 per minute.
+         */
+        get: operations["getFleetBenchmarks"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/ranking": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Opted-in agent-swarm installs ranked by tokens
+         * @description Copies OpenRouter's app-ranking category response
+         *     (`/api/frontend/v1/apps/marketplace/category`) key for key, so an
+         *     OpenRouter-style client reads it unchanged, and adds the other OpenRouter
+         *     app pages' fields under their OpenRouter names. Without `domain`:
+         *     `chart` and `titleMap` (the category chart, stacked by app) and
+         *     `trending` (the index page's fastest growing apps). With `domain`: `chart`
+         *     stacked by model, `totalTokens`, `rank`, `modelsUsed` and
+         *     `appModelAnalytics` (the app page). Tokens are the only metric served:
+         *     `total_requests` is always 0. Telemetry alone lists an install: it sent a
+         *     valid `ranking.opted_in` listing for the domain, has not opted out since,
+         *     is not an internal, test, E2B or non-production install, sent telemetry in
+         *     the last 7 days with the domain as its newest `org_website`, and its
+         *     `ranking.usage` for the domain has tokens in the period. A domain on the
+         *     proxy's denylist is never listed. When several installs list one domain,
+         *     the one whose listing was ingested first holds it (ties go to the lower
+         *     install ID) while it qualifies; the next in that order takes over when it
+         *     stops. Recomputed hourly. Called server to server by the landing, so the response sends no
+         *     CORS headers. Rate limited per IP: a burst of 10, then 10 per minute.
+         */
+        get: operations["getRanking"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/ranking/verify": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Check whether a domain would be ranked
+         * @description Reads the telemetry store live (no cache) and applies the ranking's rules
+         *     to the domain: it is not denylisted (reason `denylisted`), and an install
+         *     that listed it has not opted out since, is not excluded, sent telemetry in
+         *     the last 7 days, and still declares this domain as its website. `listing`
+         *     and the flags describe the install that would hold the domain or, when
+         *     none may, the first install that listed it. `listing` never includes a
+         *     claim. Sends no CORS headers. Rate limited per IP: a burst of 10, then 10 per
+         *     minute.
+         */
+        get: operations["verifyRankingEntry"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -101,6 +242,16 @@ export interface components {
                 [key: string]: unknown;
             };
         };
+        /** @enum {string|null} */
+        TeamSize: "1" | "2-10" | "11-50" | "51+" | null;
+        /** @enum {string|null} */
+        UseCase: "features" | "bugs" | "review" | "ops" | "docs" | "data" | null;
+        /** @enum {string|null} */
+        AcquisitionSource: "search" | "github" | "social" | "colleague" | "newsletter" | "event" | "ai_assistant" | "hacker_news" | "other" | null;
+        /** @enum {string|null} */
+        UserFunction: "engineer" | "eng_lead" | "founder" | "product" | "ops" | "other" | null;
+        /** @enum {string|null} */
+        NotificationMoment: "task_failed" | "first_workflow" | "default" | null;
         /**
          * @description Identity envelope for schema version 2. Pseudonymous by design: no email or
          *     user name is accepted, and `is_internal` is set only by the proxy.
@@ -124,7 +275,10 @@ export interface components {
             swarm_version: string;
             install_method?: string | null;
             install_preset?: string | null;
-            acquisition_source?: string | null;
+            acquisition_source?: components["schemas"]["AcquisitionSource"];
+            team_size?: components["schemas"]["TeamSize"];
+            use_case?: components["schemas"]["UseCase"];
+            user_function?: components["schemas"]["UserFunction"];
         };
         EventEnvelope: {
             /** @description Product or service emitting the telemetry event. */
@@ -224,6 +378,40 @@ export interface components {
              * @description Required RFC3339 submission timestamp.
              */
             submitted_at: string;
+            user_function?: components["schemas"]["UserFunction"];
+            team_size?: components["schemas"]["TeamSize"];
+            use_case?: components["schemas"]["UseCase"];
+            acquisition_source?: components["schemas"]["AcquisitionSource"];
+            moment?: components["schemas"]["NotificationMoment"];
+            /** @description Optional description of the submitter's current work. */
+            working_on?: string | null;
+        };
+        UsedByConsent: {
+            /** @description Agent-swarm installation identifier. Omit it when the install has none (telemetry off). */
+            install_id?: string | null;
+            org_name: string;
+            /** @description Lowercase hostname the admin declared, without scheme, `www.`, path or port. */
+            org_website: string;
+            /** @description The admin's email domain. The Slack post says whether it matches `org_website`. */
+            org_domain?: string | null;
+            /** @description true grants consent, false revokes it. */
+            granted: boolean;
+            /**
+             * Format: date-time
+             * @description When the admin changed the setting (RFC3339).
+             */
+            changed_at: string;
+            /**
+             * Format: email
+             * @description Current clients require a valid contact email when consent is granted. Older clients may omit it.
+             */
+            contact_email?: string | null;
+            contact_function?: components["schemas"]["UserFunction"];
+            quote?: string | null;
+        };
+        UsedByAcceptedResponse: {
+            /** @constant */
+            status: "accepted";
         };
         FeedbackAcceptedResponse: {
             /** @constant */
@@ -242,6 +430,150 @@ export interface components {
             /** @description Human-readable detail, such as the offending property name. */
             message: string;
         };
+        FleetBenchmarks: {
+            /** @enum {string} */
+            window: "30d";
+            /** Format: date-time */
+            generatedAt: string;
+            /** @description k-anonymity floor in installs for the whole fleet, or distinct orgs for a peer group. */
+            minInstallsPerBucket: number;
+            /** @description An install needs this many completed or failed tasks in the window to count. */
+            minFinishedTasks: number;
+            overall: components["schemas"]["FleetBenchmarkBlock"];
+            /** @description Keyed by `1`, `2-5` or `6+`. A bucket below `minInstallsPerBucket` is absent. The floor counts installs for the whole fleet and distinct orgs for peers. */
+            byAgentCount: {
+                [key: string]: components["schemas"]["FleetBenchmarkBlock"];
+            };
+            peer_group?: components["schemas"]["FleetPeerGroup"];
+        };
+        FleetPeerGroup: {
+            team_size: components["schemas"]["TeamSize"];
+            use_case: components["schemas"]["UseCase"];
+            orgs: number;
+        } | null;
+        FleetBenchmarkBlock: {
+            installs: number;
+            tasksPerWeek: components["schemas"]["FleetMetric"];
+            taskSuccessRate: components["schemas"]["FleetMetric"];
+        };
+        /** @description Linear-interpolated percentiles. Below the floor, only `n` and `omitted` are present. */
+        FleetMetric: {
+            /** @description Installs contributing to this metric. */
+            n: number;
+            p25?: number;
+            p50?: number;
+            p75?: number;
+            p90?: number;
+            omitted?: string;
+        };
+        RankingResponse: {
+            data: {
+                apps: components["schemas"]["RankingRow"][];
+                /** @description The `group` query value, or `agent-swarm` for every category. */
+                group: string;
+                /** @description The `subcategory` query value, or null. */
+                subcategory: string | null;
+                /** @description Subcategories in the group with 3 or more listed entries in the period, most entries first. */
+                subcategories: string[];
+                /** @description Subcategories in the group with 1 or 2 listed entries in the period. */
+                lowCountSubcategories: string[];
+                chart?: components["schemas"]["RankingChart"];
+                /** @description Without `domain`. The title of every `app_id` key in `chart`, like OpenRouter's category-chart `titleMap`. */
+                titleMap?: {
+                    [key: string]: string;
+                };
+                /** @description Without `domain`. Listed apps (within `group` and `subcategory`) whose period tokens grew against the previous period of the same length, most tokens gained first. An app with no tokens in the previous period has no baseline and is left out. */
+                trending?: components["schemas"]["RankingTrending"][];
+                /** @description With `domain`. Every counted day's tokens (held days excluded). */
+                totalTokens?: number;
+                /** @description With `domain`. The daily global rank (`period=day`), or null with no tokens today. */
+                rank?: number | null;
+                /** @description With `domain`. Models with tokens in the last 30 days, `unknown` included; may exceed the length of `appModelAnalytics`. */
+                modelsUsed?: number;
+                /** @description With `domain`. Tokens per model over the last 30 days, most first. */
+                appModelAnalytics?: components["schemas"]["RankingModelAnalytics"][];
+            };
+        };
+        RankingTrending: {
+            appAnalytics: components["schemas"]["RankingRow"];
+            /** @description Period tokens against the previous period of the same length, as a rounded percent increase. */
+            growthPercent: number;
+        };
+        RankingModelAnalytics: {
+            /**
+             * Format: date
+             * @description Today (UTC), the end of the 30-day window.
+             */
+            date: string;
+            /** @description The `ranking.usage` model, or `unknown`. */
+            model_permaslug: string;
+            /** @description Not an OpenRouter field. The provider that carried most of the model's tokens, or `unknown`. */
+            provider: string;
+            total_tokens: number;
+        };
+        RankingRow: {
+            /** @description Stable entry ID derived from the domain. Never an install or org ID. */
+            app_id: number;
+            /** @description Sum of `ranking.usage.totalTokens` in the period, as a decimal string like OpenRouter's. */
+            total_tokens: string;
+            /**
+             * @description Always 0. Tokens are the only public metric; the key stays for OpenRouter schema parity.
+             * @constant
+             */
+            total_requests: 0;
+            /** @description Position by tokens among every listed entry in the period, without gaps. A filtered list keeps the global rank. */
+            rank: number;
+            app: components["schemas"]["RankingApp"];
+        };
+        RankingApp: {
+            id: number;
+            /**
+             * Format: date-time
+             * @description When the entry was first served.
+             */
+            created_at: string;
+            description: string | null;
+            /** @description The listing name (the install's SWARM_ORG_NAME). */
+            title: string;
+            main_url: string | null;
+            origin_url: string | null;
+            /** @description The entry's domain. */
+            slug: string | null;
+            source_code_url: string | null;
+            icon_class_name: string;
+            /** @description This service's `GET /v1/logo` for the domain. */
+            favicon_url: string;
+            /** @description The listing subcategory, or empty. */
+            categories: string[];
+            related_apps: number[];
+        };
+        /** @description OpenRouter's `{x, ys}` chart, oldest point first. `daily` is today and the 30 days before, with `x` as `YYYY-MM-DD 00:00:00`. `weekly` is Monday-based with `x` as `YYYY-MM-DD`: 52 weeks without `domain`, and from the entry's first week (first served or first counted day) with `domain`, at most 52. With `domain`, `ys` keys are models (the top 10 of the point); without it, `app_id`s as strings (the top 9). The rest sum into `Others`. A series with no tokens is left out, so `ys` can be empty. An unknown or hidden `domain` gets empty `daily` and `weekly`. */
+        RankingChart: {
+            daily: components["schemas"]["RankingChartPoint"][];
+            weekly: components["schemas"]["RankingChartPoint"][];
+        };
+        RankingChartPoint: {
+            x: string;
+            ys: {
+                [key: string]: number;
+            };
+        };
+        RankingVerification: {
+            verified: boolean;
+            reasons: ("no_listing" | "denylisted" | "opted_out" | "excluded_install" | "telemetry_inactive_7d" | "website_mismatch")[];
+            telemetryActive7d: boolean;
+            /** @description The install's newest event declares this domain as its org_website. */
+            websiteMatchesDomain: boolean;
+            listing: components["schemas"]["RankingPublicListing"] | null;
+        };
+        RankingPublicListing: {
+            name: string;
+            domain: string;
+            category: string;
+            subcategory: string | null;
+            description: string | null;
+            sourceCodeUrl: string | null;
+        };
         ProblemResponse: {
             code: string;
             message: string;
@@ -376,6 +708,7 @@ export interface components {
             properties: components["schemas"]["AgentSwarmCompactionTriggeredProperties"];
         };
         AgentSwarmFeatureUsedProperties: {
+            /** @description Feature identifier, including health_popover and kickoff_call_opened. Existing identifiers remain accepted. */
             feature: string;
             /** @description An email channel is configured. */
             has_email_channel?: boolean;
@@ -405,6 +738,37 @@ export interface components {
             product: "agent-swarm";
             properties: components["schemas"]["AgentSwarmFeatureUsedProperties"];
         };
+        AgentSwarmFleetBenchmarkUnlockedProperties: {
+            /** @description Profile fields supplied, never their values. */
+            fields: ("website" | "team_size" | "use_case")[];
+            /** @description An email channel is configured. */
+            has_email_channel?: boolean;
+            /** @description An embedding API key is configured. */
+            has_embedding_key?: boolean;
+            /** @description A notification channel is configured. */
+            has_notification_channel?: boolean;
+            /** @description A Slack channel is configured. */
+            has_slack_channel?: boolean;
+            /** @description Legacy key kept during the v1 window; v2 carries context.install_method. */
+            install_method?: string;
+            /** @description Legacy key kept during the v1 window; v2 carries context.deployment. */
+            is_cloud?: boolean;
+            /** @description Legacy key kept during the v1 window; v2 carries context.deployment. */
+            is_e2b?: boolean;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+        };
+        /** @description An admin supplied the company profile fields for the full benchmark. (emitter: ui, since 2026-10-18) */
+        AgentSwarmFleetBenchmarkUnlockedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "fleet_benchmark.unlocked";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmFleetBenchmarkUnlockedProperties"];
+        };
         AgentSwarmFleetBenchmarkViewedProperties: {
             /** @description An email channel is configured. */
             has_email_channel?: boolean;
@@ -421,6 +785,8 @@ export interface components {
             is_cloud?: boolean;
             /** @description Legacy key kept during the v1 window; v2 carries context.deployment. */
             is_e2b?: boolean;
+            /** @enum {string} */
+            level?: "basic" | "full";
             /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
             swarmVersion?: string;
         };
@@ -435,6 +801,71 @@ export interface components {
             product: "agent-swarm";
             properties: components["schemas"]["AgentSwarmFleetBenchmarkViewedProperties"];
         };
+        AgentSwarmIdentityLookupProperties: {
+            /** @description An email channel is configured. */
+            has_email_channel?: boolean;
+            /** @description An embedding API key is configured. */
+            has_embedding_key?: boolean;
+            /** @description A notification channel is configured. */
+            has_notification_channel?: boolean;
+            /** @description A Slack channel is configured. */
+            has_slack_channel?: boolean;
+            /** @description Legacy key kept during the v1 window; v2 carries context.install_method. */
+            install_method?: string;
+            /** @description Legacy key kept during the v1 window; v2 carries context.deployment. */
+            is_cloud?: boolean;
+            /** @description Legacy key kept during the v1 window; v2 carries context.deployment. */
+            is_e2b?: boolean;
+            matched: boolean;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+        };
+        /** @description A dashboard identity lookup matched an existing user or found no match. (emitter: ui, since 2026-10-18) */
+        AgentSwarmIdentityLookupEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "identity.lookup";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmIdentityLookupProperties"];
+        };
+        AgentSwarmIdentityUserCreatedProperties: {
+            /** @enum {string} */
+            email_kind: "work" | "personal";
+            has_company: boolean;
+            /** @description An email channel is configured. */
+            has_email_channel?: boolean;
+            /** @description An embedding API key is configured. */
+            has_embedding_key?: boolean;
+            has_function: boolean;
+            /** @description A notification channel is configured. */
+            has_notification_channel?: boolean;
+            /** @description A Slack channel is configured. */
+            has_slack_channel?: boolean;
+            /** @description Legacy key kept during the v1 window; v2 carries context.install_method. */
+            install_method?: string;
+            /** @description Legacy key kept during the v1 window; v2 carries context.deployment. */
+            is_cloud?: boolean;
+            /** @description Legacy key kept during the v1 window; v2 carries context.deployment. */
+            is_e2b?: boolean;
+            /** @enum {string} */
+            surface: "identity_modal" | "setup";
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+        };
+        /** @description A user created a dashboard identity. Email and personal names stay out of telemetry. (emitter: ui, since 2026-10-18) */
+        AgentSwarmIdentityUserCreatedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "identity.user_created";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmIdentityUserCreatedProperties"];
+        };
         AgentSwarmIntegrationConnectedProperties: {
             first_of_type: boolean;
             /** @description An email channel is configured. */
@@ -468,6 +899,7 @@ export interface components {
             properties: components["schemas"]["AgentSwarmIntegrationConnectedProperties"];
         };
         AgentSwarmLeadCapturedProperties: {
+            /** @description Lead channel, including setup_help and fleet_report. Existing channels remain accepted. */
             channel: string;
             consent: boolean;
             /** @description An email channel is configured. */
@@ -499,6 +931,11 @@ export interface components {
             product: "agent-swarm";
             properties: components["schemas"]["AgentSwarmLeadCapturedProperties"];
         };
+        /**
+         * @description Moment that made the Slack Connect invite relevant.
+         * @enum {string}
+         */
+        "schemas-NotificationMoment": "task_failed" | "first_workflow" | "default";
         AgentSwarmNotificationDismissedProperties: {
             /** @description An email channel is configured. */
             has_email_channel?: boolean;
@@ -515,6 +952,7 @@ export interface components {
             /** @description Legacy key kept during the v1 window; v2 carries context.deployment. */
             is_e2b?: boolean;
             key: string;
+            moment?: components["schemas"]["schemas-NotificationMoment"];
             /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
             swarmVersion?: string;
         };
@@ -529,6 +967,11 @@ export interface components {
             product: "agent-swarm";
             properties: components["schemas"]["AgentSwarmNotificationDismissedProperties"];
         };
+        /**
+         * @description Job function of a user, separate from the RBAC user_role.
+         * @enum {string}
+         */
+        "schemas-UserFunction": "engineer" | "eng_lead" | "founder" | "product" | "ops" | "other";
         AgentSwarmNotificationSubmittedProperties: {
             /** @description Domain of the email typed into the item, never the address. */
             email_domain?: string;
@@ -547,8 +990,10 @@ export interface components {
             /** @description Legacy key kept during the v1 window; v2 carries context.deployment. */
             is_e2b?: boolean;
             key: string;
+            moment?: components["schemas"]["schemas-NotificationMoment"];
             /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
             swarmVersion?: string;
+            user_function?: components["schemas"]["schemas-UserFunction"];
         };
         /** @description A notification-centre item was submitted. (emitter: ui, since 2026-09-30) */
         AgentSwarmNotificationSubmittedEvent: {
@@ -577,6 +1022,7 @@ export interface components {
             /** @description Legacy key kept during the v1 window; v2 carries context.deployment. */
             is_e2b?: boolean;
             key: string;
+            moment?: components["schemas"]["schemas-NotificationMoment"];
             /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
             swarmVersion?: string;
         };
@@ -849,8 +1295,8 @@ export interface components {
             properties: components["schemas"]["AgentSwarmOnboardingStepViewedProperties"];
         };
         AgentSwarmOrgProfileUpdatedProperties: {
-            /** @description Changed field names: name, website. */
-            fields: unknown[];
+            /** @description Changed profile field names, never their values. */
+            fields: ("name" | "website" | "team_size" | "use_case" | "acquisition_source")[];
             /** @description An email channel is configured. */
             has_email_channel?: boolean;
             /** @description An embedding API key is configured. */
@@ -869,7 +1315,7 @@ export interface components {
              * @description Where the change was made. Not trigger_surface: that key fills the raw_events.trigger_surface column.
              * @enum {string}
              */
-            surface: "prompt" | "setup" | "settings";
+            surface: "prompt" | "setup" | "settings" | "org_name_popup" | "feedback" | "fleet_benchmark" | "telemetry_banner" | "identity_modal";
             /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
             swarmVersion?: string;
         };
@@ -1041,6 +1487,8 @@ export interface components {
             properties: components["schemas"]["AgentSwarmPopupShownProperties"];
         };
         AgentSwarmPopupSubmittedProperties: {
+            /** @description Number of profile follow-up questions answered, never their values. */
+            answered?: number;
             /** @description A name or email was left. The values go to /v1/feedback, never here. */
             has_contact: boolean;
             /** @description An email channel is configured. */
@@ -1058,6 +1506,8 @@ export interface components {
             is_cloud?: boolean;
             /** @description Legacy key kept during the v1 window; v2 carries context.deployment. */
             is_e2b?: boolean;
+            /** @description Perks the admin explicitly selected. */
+            perks?: ("used_by" | "slack_connect")[];
             popup: components["schemas"]["Popup"];
             /** @description Feedback pop-up only: the 0-10 score. /v1/feedback enforces the upper bound. */
             score?: number;
@@ -1075,8 +1525,7 @@ export interface components {
             product: "agent-swarm";
             properties: components["schemas"]["AgentSwarmPopupSubmittedProperties"];
         };
-        AgentSwarmScheduleErrorProperties: {
-            consecutiveErrors: number;
+        AgentSwarmRankingOptedInProperties: {
             /** @description An email channel is configured. */
             has_email_channel?: boolean;
             /** @description An embedding API key is configured. */
@@ -1091,24 +1540,25 @@ export interface components {
             is_cloud?: boolean;
             /** @description Legacy key kept during the v1 window; v2 carries context.deployment. */
             is_e2b?: boolean;
-            scheduleType: string;
+            /** @description The stringified telemetry_ranking listing (contracts/telemetry/ranking/listing.v1.schema.json). The ingest also requires its name and domain to equal context.org_name and context.org_website. */
+            listing: string;
             /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
             swarmVersion?: string;
-            triggeredWorkflows: boolean;
-            wasRecovered: boolean;
         };
-        /** @description A schedule failed to fire. (emitter: api-server, since 2026-09-30) */
-        AgentSwarmScheduleErrorEvent: {
+        /** @description An admin opted the install into the public ranking, or the API rebuilt its listing after an org identity change. (emitter: api-server, since 2026-10-18) */
+        AgentSwarmRankingOptedInEvent: {
             /**
              * @description discriminator enum property added by openapi-typescript
              * @enum {string}
              */
-            event: "schedule.error";
+            event: "ranking.opted_in";
             /** @constant */
             product: "agent-swarm";
-            properties: components["schemas"]["AgentSwarmScheduleErrorProperties"];
+            properties: components["schemas"]["AgentSwarmRankingOptedInProperties"];
         };
-        AgentSwarmScheduleExecutedProperties: {
+        AgentSwarmRankingOptedOutProperties: {
+            /** @description The listing domain that leaves the ranking: a lowercase hostname. */
+            domain: string;
             /** @description An email channel is configured. */
             has_email_channel?: boolean;
             /** @description An embedding API key is configured. */
@@ -1123,24 +1573,23 @@ export interface components {
             is_cloud?: boolean;
             /** @description Legacy key kept during the v1 window; v2 carries context.deployment. */
             is_e2b?: boolean;
-            scheduleType: string;
             /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
             swarmVersion?: string;
-            triggeredWorkflows: boolean;
-            wasRecovered: boolean;
         };
-        /** @description A schedule fired. (emitter: api-server, since 2026-09-30) */
-        AgentSwarmScheduleExecutedEvent: {
+        /** @description The install left the public ranking: the admin turned it off, or the org name or website was cleared or changed. (emitter: api-server, since 2026-10-18) */
+        AgentSwarmRankingOptedOutEvent: {
             /**
              * @description discriminator enum property added by openapi-typescript
              * @enum {string}
              */
-            event: "schedule.executed";
+            event: "ranking.opted_out";
             /** @constant */
             product: "agent-swarm";
-            properties: components["schemas"]["AgentSwarmScheduleExecutedProperties"];
+            properties: components["schemas"]["AgentSwarmRankingOptedOutProperties"];
         };
-        AgentSwarmServerShutdownProperties: {
+        AgentSwarmRankingUsageProperties: {
+            cacheReadTokens?: number;
+            cacheWriteTokens?: number;
             /** @description An email channel is configured. */
             has_email_channel?: boolean;
             /** @description An embedding API key is configured. */
@@ -1149,30 +1598,36 @@ export interface components {
             has_notification_channel?: boolean;
             /** @description A Slack channel is configured. */
             has_slack_channel?: boolean;
+            inputTokens: number;
             /** @description Legacy key kept during the v1 window; v2 carries context.install_method. */
             install_method?: string;
             /** @description Legacy key kept during the v1 window; v2 carries context.deployment. */
             is_cloud?: boolean;
             /** @description Legacy key kept during the v1 window; v2 carries context.deployment. */
             is_e2b?: boolean;
-            sessionsProcessed: number;
-            signal: string;
+            /** @description The session's model, the same value as session.cost.model. Usage without it, or with a value the ranking does not accept, is shown as the model unknown. */
+            model?: string;
+            outputTokens: number;
+            /** @description The session's provider, the same value as session.cost.provider. Missing means unknown. */
+            provider?: string;
             /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
             swarmVersion?: string;
-            uptimeMs: number;
+            /** @description inputTokens + cacheReadTokens + cacheWriteTokens + outputTokens. The ranking sums this. */
+            totalTokens: number;
         };
-        /** @description The API server shut down. (emitter: api-server, since 2026-09-30) */
-        AgentSwarmServerShutdownEvent: {
+        /** @description Token usage of one session on an install opted into the public ranking. Sent next to session.cost. (emitter: worker, since 2026-10-18) */
+        AgentSwarmRankingUsageEvent: {
             /**
              * @description discriminator enum property added by openapi-typescript
              * @enum {string}
              */
-            event: "server.shutdown";
+            event: "ranking.usage";
             /** @constant */
             product: "agent-swarm";
-            properties: components["schemas"]["AgentSwarmServerShutdownProperties"];
+            properties: components["schemas"]["AgentSwarmRankingUsageProperties"];
         };
-        AgentSwarmServerStartedProperties: {
+        AgentSwarmScheduleErrorProperties: {
+            consecutiveErrors: number;
             /** @description An email channel is configured. */
             has_email_channel?: boolean;
             /** @description An embedding API key is configured. */
@@ -1187,30 +1642,24 @@ export interface components {
             is_cloud?: boolean;
             /** @description Legacy key kept during the v1 window; v2 carries context.deployment. */
             is_e2b?: boolean;
-            port: number;
+            scheduleType: string;
             /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
             swarmVersion?: string;
+            triggeredWorkflows: boolean;
+            wasRecovered: boolean;
         };
-        /** @description The API server started. (emitter: api-server, since 2026-09-30) */
-        AgentSwarmServerStartedEvent: {
+        /** @description A schedule failed to fire. (emitter: api-server, since 2026-09-30) */
+        AgentSwarmScheduleErrorEvent: {
             /**
              * @description discriminator enum property added by openapi-typescript
              * @enum {string}
              */
-            event: "server.started";
+            event: "schedule.error";
             /** @constant */
             product: "agent-swarm";
-            properties: components["schemas"]["AgentSwarmServerStartedProperties"];
+            properties: components["schemas"]["AgentSwarmScheduleErrorProperties"];
         };
-        /**
-         * @description Surface that started a chain of work: agent-swarm's AgentTaskSourceSchema values plus other.
-         * @enum {string}
-         */
-        TriggerSurface: "slack" | "ui" | "api" | "mcp" | "github" | "gitlab" | "linear" | "jira" | "agentmail" | "schedule" | "workflow" | "system" | "other";
-        AgentSwarmSessionCancelledProperties: {
-            agentId: string;
-            durationMs: number;
-            errorCategory: string;
+        AgentSwarmScheduleExecutedProperties: {
             /** @description An email channel is configured. */
             has_email_channel?: boolean;
             /** @description An embedding API key is configured. */
@@ -1225,28 +1674,130 @@ export interface components {
             is_cloud?: boolean;
             /** @description Legacy key kept during the v1 window; v2 carries context.deployment. */
             is_e2b?: boolean;
-            model: string;
-            provider: string;
+            scheduleType: string;
             /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
             swarmVersion?: string;
-            /** @description Task the session ran, or null for a session with no task. */
-            taskId: string | null;
-            /** @description Root surface of the task, or null for a session with no task. */
-            trigger_surface: components["schemas"]["TriggerSurface"] | null;
-            wasRateLimited: boolean;
+            triggeredWorkflows: boolean;
+            wasRecovered: boolean;
         };
-        /** @description A session was cancelled. (emitter: worker, since 2026-09-30) */
-        AgentSwarmSessionCancelledEvent: {
+        /** @description A schedule fired. (emitter: api-server, since 2026-09-30) */
+        AgentSwarmScheduleExecutedEvent: {
             /**
              * @description discriminator enum property added by openapi-typescript
              * @enum {string}
              */
-            event: "session.cancelled";
+            event: "schedule.executed";
             /** @constant */
             product: "agent-swarm";
-            properties: components["schemas"]["AgentSwarmSessionCancelledProperties"];
+            properties: components["schemas"]["AgentSwarmScheduleExecutedProperties"];
         };
-        AgentSwarmSessionCostProperties: {
+        AgentSwarmServerShutdownProperties: {
+            /** @description An email channel is configured. */
+            has_email_channel?: boolean;
+            /** @description An embedding API key is configured. */
+            has_embedding_key?: boolean;
+            /** @description A notification channel is configured. */
+            has_notification_channel?: boolean;
+            /** @description A Slack channel is configured. */
+            has_slack_channel?: boolean;
+            /** @description Legacy key kept during the v1 window; v2 carries context.install_method. */
+            install_method?: string;
+            /** @description Legacy key kept during the v1 window; v2 carries context.deployment. */
+            is_cloud?: boolean;
+            /** @description Legacy key kept during the v1 window; v2 carries context.deployment. */
+            is_e2b?: boolean;
+            sessionsProcessed: number;
+            signal: string;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+            uptimeMs: number;
+        };
+        /** @description The API server shut down. (emitter: api-server, since 2026-09-30) */
+        AgentSwarmServerShutdownEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "server.shutdown";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmServerShutdownProperties"];
+        };
+        AgentSwarmServerStartedProperties: {
+            /** @description An email channel is configured. */
+            has_email_channel?: boolean;
+            /** @description An embedding API key is configured. */
+            has_embedding_key?: boolean;
+            /** @description A notification channel is configured. */
+            has_notification_channel?: boolean;
+            /** @description A Slack channel is configured. */
+            has_slack_channel?: boolean;
+            /** @description Legacy key kept during the v1 window; v2 carries context.install_method. */
+            install_method?: string;
+            /** @description Legacy key kept during the v1 window; v2 carries context.deployment. */
+            is_cloud?: boolean;
+            /** @description Legacy key kept during the v1 window; v2 carries context.deployment. */
+            is_e2b?: boolean;
+            port: number;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+        };
+        /** @description The API server started. (emitter: api-server, since 2026-09-30) */
+        AgentSwarmServerStartedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "server.started";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmServerStartedProperties"];
+        };
+        /**
+         * @description Surface that started a chain of work: agent-swarm's AgentTaskSourceSchema values plus other.
+         * @enum {string}
+         */
+        TriggerSurface: "slack" | "ui" | "api" | "mcp" | "github" | "gitlab" | "linear" | "jira" | "agentmail" | "schedule" | "workflow" | "system" | "other";
+        AgentSwarmSessionCancelledProperties: {
+            agentId: string;
+            durationMs: number;
+            errorCategory: string;
+            /** @description An email channel is configured. */
+            has_email_channel?: boolean;
+            /** @description An embedding API key is configured. */
+            has_embedding_key?: boolean;
+            /** @description A notification channel is configured. */
+            has_notification_channel?: boolean;
+            /** @description A Slack channel is configured. */
+            has_slack_channel?: boolean;
+            /** @description Legacy key kept during the v1 window; v2 carries context.install_method. */
+            install_method?: string;
+            /** @description Legacy key kept during the v1 window; v2 carries context.deployment. */
+            is_cloud?: boolean;
+            /** @description Legacy key kept during the v1 window; v2 carries context.deployment. */
+            is_e2b?: boolean;
+            model: string;
+            provider: string;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+            /** @description Task the session ran, or null for a session with no task. */
+            taskId: string | null;
+            /** @description Root surface of the task, or null for a session with no task. */
+            trigger_surface: components["schemas"]["TriggerSurface"] | null;
+            wasRateLimited: boolean;
+        };
+        /** @description A session was cancelled. (emitter: worker, since 2026-09-30) */
+        AgentSwarmSessionCancelledEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "session.cancelled";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmSessionCancelledProperties"];
+        };
+        AgentSwarmSessionCostProperties: {
             agentId: string;
             cacheReadTokens?: number;
             cacheWriteTokens?: number;
@@ -1436,6 +1987,39 @@ export interface components {
             product: "agent-swarm";
             properties: components["schemas"]["AgentSwarmSessionSteeredProperties"];
         };
+        AgentSwarmSetupWorkerCommandCopiedProperties: {
+            /** @enum {string} */
+            harness: "claude" | "codex" | "pi" | "devin" | "claude-managed" | "opencode" | "acp" | "dsh" | "amp" | "cursor" | "grok";
+            /** @description An email channel is configured. */
+            has_email_channel?: boolean;
+            /** @description An embedding API key is configured. */
+            has_embedding_key?: boolean;
+            /** @description A notification channel is configured. */
+            has_notification_channel?: boolean;
+            /** @description A Slack channel is configured. */
+            has_slack_channel?: boolean;
+            /** @description Legacy key kept during the v1 window; v2 carries context.install_method. */
+            install_method?: string;
+            /** @description Legacy key kept during the v1 window; v2 carries context.deployment. */
+            is_cloud?: boolean;
+            /** @description Legacy key kept during the v1 window; v2 carries context.deployment. */
+            is_e2b?: boolean;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+            /** @enum {string} */
+            target: "compose" | "docker" | "kubernetes";
+        };
+        /** @description An admin copied a worker command from the setup health popover. (emitter: ui, since 2026-10-18) */
+        AgentSwarmSetupWorkerCommandCopiedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "setup.worker_command_copied";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmSetupWorkerCommandCopiedProperties"];
+        };
         AgentSwarmSkillInvokedProperties: {
             /** @description An email channel is configured. */
             has_email_channel?: boolean;
@@ -1793,7 +2377,7 @@ export interface components {
             /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
             swarmVersion?: string;
             /** @enum {string} */
-            via: "banner" | "settings" | "env";
+            via: "banner" | "settings" | "env" | "benchmark";
         };
         /** @description Telemetry was turned on. Sent once, on the first boot or re-init after opting in. (emitter: api-server, since 2026-10-12) */
         AgentSwarmTelemetryEnabledEvent: {
@@ -1841,8 +2425,10 @@ export interface components {
             has_email_channel?: boolean;
             /** @description An embedding API key is configured. */
             has_embedding_key?: boolean;
+            has_function?: boolean;
             /** @description A notification channel is configured. */
             has_notification_channel?: boolean;
+            has_quote?: boolean;
             /** @description A Slack channel is configured. */
             has_slack_channel?: boolean;
             /** @description Legacy key kept during the v1 window; v2 carries context.install_method. */
@@ -2034,7 +2620,7 @@ export interface components {
             product: "agent-swarm";
             properties: components["schemas"]["AgentSwarmWorkflowStartedProperties"];
         };
-        AgentSwarmCatalogEvent: components["schemas"]["AgentSwarmAgentRegisteredEvent"] | components["schemas"]["AgentSwarmCompactionTriggeredEvent"] | components["schemas"]["AgentSwarmFeatureUsedEvent"] | components["schemas"]["AgentSwarmFleetBenchmarkViewedEvent"] | components["schemas"]["AgentSwarmIntegrationConnectedEvent"] | components["schemas"]["AgentSwarmLeadCapturedEvent"] | components["schemas"]["AgentSwarmNotificationDismissedEvent"] | components["schemas"]["AgentSwarmNotificationSubmittedEvent"] | components["schemas"]["AgentSwarmNotificationViewedEvent"] | components["schemas"]["AgentSwarmOnboardingCompletedEvent"] | components["schemas"]["AgentSwarmOnboardingDismissedEvent"] | components["schemas"]["AgentSwarmOnboardingFirstTaskCompletedEvent"] | components["schemas"]["AgentSwarmOnboardingStartedEvent"] | components["schemas"]["AgentSwarmOnboardingStepCompletedEvent"] | components["schemas"]["AgentSwarmOnboardingStepFailedEvent"] | components["schemas"]["AgentSwarmOnboardingStepSkippedEvent"] | components["schemas"]["AgentSwarmOnboardingStepViewedEvent"] | components["schemas"]["AgentSwarmOrgProfileUpdatedEvent"] | components["schemas"]["AgentSwarmOrgSnapshotEvent"] | components["schemas"]["AgentSwarmPageViewedEvent"] | components["schemas"]["AgentSwarmPopupDismissedEvent"] | components["schemas"]["AgentSwarmPopupShownEvent"] | components["schemas"]["AgentSwarmPopupSubmittedEvent"] | components["schemas"]["AgentSwarmScheduleErrorEvent"] | components["schemas"]["AgentSwarmScheduleExecutedEvent"] | components["schemas"]["AgentSwarmServerShutdownEvent"] | components["schemas"]["AgentSwarmServerStartedEvent"] | components["schemas"]["AgentSwarmSessionCancelledEvent"] | components["schemas"]["AgentSwarmSessionCostEvent"] | components["schemas"]["AgentSwarmSessionEndedEvent"] | components["schemas"]["AgentSwarmSessionFailureEvent"] | components["schemas"]["AgentSwarmSessionStartedEvent"] | components["schemas"]["AgentSwarmSessionSteeredEvent"] | components["schemas"]["AgentSwarmSkillInvokedEvent"] | components["schemas"]["AgentSwarmTaskCancelledEvent"] | components["schemas"]["AgentSwarmTaskClaimedEvent"] | components["schemas"]["AgentSwarmTaskCompletedEvent"] | components["schemas"]["AgentSwarmTaskCreatedEvent"] | components["schemas"]["AgentSwarmTaskFailedEvent"] | components["schemas"]["AgentSwarmTaskSessionCompletedEvent"] | components["schemas"]["AgentSwarmTaskStartedEvent"] | components["schemas"]["AgentSwarmTaskSupersededEvent"] | components["schemas"]["AgentSwarmTelemetryEnabledEvent"] | components["schemas"]["AgentSwarmUiSessionStartedEvent"] | components["schemas"]["AgentSwarmUsedByConsentChangedEvent"] | components["schemas"]["AgentSwarmWorkflowCompletedEvent"] | components["schemas"]["AgentSwarmWorkflowCreatedEvent"] | components["schemas"]["AgentSwarmWorkflowDeletedEvent"] | components["schemas"]["AgentSwarmWorkflowFailedEvent"] | components["schemas"]["AgentSwarmWorkflowStartedEvent"];
+        AgentSwarmCatalogEvent: components["schemas"]["AgentSwarmAgentRegisteredEvent"] | components["schemas"]["AgentSwarmCompactionTriggeredEvent"] | components["schemas"]["AgentSwarmFeatureUsedEvent"] | components["schemas"]["AgentSwarmFleetBenchmarkUnlockedEvent"] | components["schemas"]["AgentSwarmFleetBenchmarkViewedEvent"] | components["schemas"]["AgentSwarmIdentityLookupEvent"] | components["schemas"]["AgentSwarmIdentityUserCreatedEvent"] | components["schemas"]["AgentSwarmIntegrationConnectedEvent"] | components["schemas"]["AgentSwarmLeadCapturedEvent"] | components["schemas"]["AgentSwarmNotificationDismissedEvent"] | components["schemas"]["AgentSwarmNotificationSubmittedEvent"] | components["schemas"]["AgentSwarmNotificationViewedEvent"] | components["schemas"]["AgentSwarmOnboardingCompletedEvent"] | components["schemas"]["AgentSwarmOnboardingDismissedEvent"] | components["schemas"]["AgentSwarmOnboardingFirstTaskCompletedEvent"] | components["schemas"]["AgentSwarmOnboardingStartedEvent"] | components["schemas"]["AgentSwarmOnboardingStepCompletedEvent"] | components["schemas"]["AgentSwarmOnboardingStepFailedEvent"] | components["schemas"]["AgentSwarmOnboardingStepSkippedEvent"] | components["schemas"]["AgentSwarmOnboardingStepViewedEvent"] | components["schemas"]["AgentSwarmOrgProfileUpdatedEvent"] | components["schemas"]["AgentSwarmOrgSnapshotEvent"] | components["schemas"]["AgentSwarmPageViewedEvent"] | components["schemas"]["AgentSwarmPopupDismissedEvent"] | components["schemas"]["AgentSwarmPopupShownEvent"] | components["schemas"]["AgentSwarmPopupSubmittedEvent"] | components["schemas"]["AgentSwarmRankingOptedInEvent"] | components["schemas"]["AgentSwarmRankingOptedOutEvent"] | components["schemas"]["AgentSwarmRankingUsageEvent"] | components["schemas"]["AgentSwarmScheduleErrorEvent"] | components["schemas"]["AgentSwarmScheduleExecutedEvent"] | components["schemas"]["AgentSwarmServerShutdownEvent"] | components["schemas"]["AgentSwarmServerStartedEvent"] | components["schemas"]["AgentSwarmSessionCancelledEvent"] | components["schemas"]["AgentSwarmSessionCostEvent"] | components["schemas"]["AgentSwarmSessionEndedEvent"] | components["schemas"]["AgentSwarmSessionFailureEvent"] | components["schemas"]["AgentSwarmSessionStartedEvent"] | components["schemas"]["AgentSwarmSessionSteeredEvent"] | components["schemas"]["AgentSwarmSetupWorkerCommandCopiedEvent"] | components["schemas"]["AgentSwarmSkillInvokedEvent"] | components["schemas"]["AgentSwarmTaskCancelledEvent"] | components["schemas"]["AgentSwarmTaskClaimedEvent"] | components["schemas"]["AgentSwarmTaskCompletedEvent"] | components["schemas"]["AgentSwarmTaskCreatedEvent"] | components["schemas"]["AgentSwarmTaskFailedEvent"] | components["schemas"]["AgentSwarmTaskSessionCompletedEvent"] | components["schemas"]["AgentSwarmTaskStartedEvent"] | components["schemas"]["AgentSwarmTaskSupersededEvent"] | components["schemas"]["AgentSwarmTelemetryEnabledEvent"] | components["schemas"]["AgentSwarmUiSessionStartedEvent"] | components["schemas"]["AgentSwarmUsedByConsentChangedEvent"] | components["schemas"]["AgentSwarmWorkflowCompletedEvent"] | components["schemas"]["AgentSwarmWorkflowCreatedEvent"] | components["schemas"]["AgentSwarmWorkflowDeletedEvent"] | components["schemas"]["AgentSwarmWorkflowFailedEvent"] | components["schemas"]["AgentSwarmWorkflowStartedEvent"];
         /** @description Every catalogued (product, event) pair with its property schema. Generated from contracts/telemetry/catalog/events.json. */
         CatalogEvent: components["schemas"]["AgentFsCatalogEvent"] | components["schemas"]["AgentSwarmCatalogEvent"];
     };
@@ -2212,4 +2798,323 @@ export interface operations {
             204: components["responses"]["CORSPreflightResponse"];
         };
     };
+    submitUsedByConsent: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UsedByConsent"];
+            };
+        };
+        responses: {
+            /** @description Consent change persisted; the Slack post is best-effort. */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["UsedByAcceptedResponse"];
+                };
+            };
+            /** @description Request body is invalid JSON or failed field validation. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemResponse"];
+                };
+            };
+            /** @description Request body exceeds 4 KB. */
+            413: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemResponse"];
+                };
+            };
+            /** @description The source IP exceeded 5 requests per minute. */
+            429: {
+                headers: {
+                    /** @description Seconds to wait before retrying. */
+                    "Retry-After"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemResponse"];
+                };
+            };
+            /** @description The consent change could not be persisted. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemResponse"];
+                };
+            };
+            /** @description Used-by storage is not configured. */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemResponse"];
+                };
+            };
+        };
+    };
+    getOrgLogo: {
+        parameters: {
+            query: {
+                /** @description Lowercase website hostname, without scheme, `www.`, path or port. IP literals are refused. */
+                domain: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The logo image. */
+            200: {
+                headers: {
+                    /** @description `public, max-age=86400`. */
+                    "Cache-Control"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "image/png": string;
+                };
+            };
+            /** @description `domain` is missing or not a hostname (code `invalid_domain`). */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemResponse"];
+                };
+            };
+            /** @description logo.dev has no image for this domain (code `logo_not_found`). */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemResponse"];
+                };
+            };
+            /** @description The source IP exceeded the logo rate limit. */
+            429: {
+                headers: {
+                    /** @description Seconds to wait before retrying. */
+                    "Retry-After"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemResponse"];
+                };
+            };
+            /** @description logo.dev failed or returned something other than a raster image under 256 KB (code `logo_upstream_failed`). Not cached. */
+            502: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemResponse"];
+                };
+            };
+            /** @description `LOGO_DEV_TOKEN` is not set (code `logo_unavailable`). */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemResponse"];
+                };
+            };
+        };
+    };
+    getFleetBenchmarks: {
+        parameters: {
+            query?: {
+                /** @description Only `30d` is supported. */
+                window?: "30d";
+                team_size?: "1" | "2-10" | "11-50" | "51+";
+                use_case?: "features" | "bugs" | "review" | "ops" | "docs" | "data";
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The latest computed benchmark. */
+            200: {
+                headers: {
+                    /** @description `public, max-age=3600`. */
+                    "Cache-Control"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FleetBenchmarks"];
+                };
+            };
+            /** @description Invalid window or profile filter (invalid_window, invalid_team_size, invalid_use_case). */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemResponse"];
+                };
+            };
+            /** @description The source IP exceeded the benchmark rate limit. */
+            429: {
+                headers: {
+                    /** @description Seconds to wait before retrying. */
+                    "Retry-After"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemResponse"];
+                };
+            };
+            /** @description No benchmark has been computed yet, for example right after boot (code `benchmarks_unavailable`). */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemResponse"];
+                };
+            };
+        };
+    };
+    getRanking: {
+        parameters: {
+            query?: {
+                /** @description The last 1, 7 or 30 UTC days, today included. */
+                period?: "day" | "week" | "month";
+                /** @description A category from `contracts/telemetry/ranking/taxonomy.json`. `agent-swarm` or absent means every category. */
+                group?: string;
+                /** @description A subcategory from the taxonomy, inside `group` when one is given. */
+                subcategory?: string;
+                /** @description Return only this entry and its app page fields. An unknown or hidden domain returns an empty `apps` list, an empty chart, zero totals and a null `rank`. */
+                domain?: string;
+                /** @description Accepted for parity with OpenRouter's collector. Only `tokens` is supported. */
+                sortBy?: "tokens";
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The ranking for the period and filters. */
+            200: {
+                headers: {
+                    /** @description `public, max-age=3600`. */
+                    "Cache-Control"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RankingResponse"];
+                };
+            };
+            /** @description A query value is not allowed (codes `invalid_period`, `invalid_group`, `invalid_subcategory`, `invalid_domain`, `invalid_sort`). */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemResponse"];
+                };
+            };
+            /** @description The source IP exceeded the ranking rate limit. */
+            429: {
+                headers: {
+                    /** @description Seconds to wait before retrying. */
+                    "Retry-After"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemResponse"];
+                };
+            };
+            /** @description The ranking has not been computed yet, for example right after boot (code `ranking_unavailable`). */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemResponse"];
+                };
+            };
+        };
+    };
+    verifyRankingEntry: {
+        parameters: {
+            query: {
+                domain: string;
+                /**
+                 * @deprecated
+                 * @description Sent by agent-swarm v2.4.0's PR check. Ignored.
+                 */
+                claim?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The verification result. A failed check is still a 200 with `verified` false. */
+            200: {
+                headers: {
+                    /** @description `no-store`. */
+                    "Cache-Control"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RankingVerification"];
+                };
+            };
+            /** @description `domain` is malformed (code `invalid_domain`). */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemResponse"];
+                };
+            };
+            /** @description The source IP exceeded the verify rate limit. */
+            429: {
+                headers: {
+                    /** @description Seconds to wait before retrying. */
+                    "Retry-After"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemResponse"];
+                };
+            };
+            /** @description The telemetry store could not be read (code `ranking_unavailable`). */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemResponse"];
+                };
+            };
+        };
+    };
 }