@desplega.ai/agent-swarm 1.161.0 → 1.162.0

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

@@ -0,0 +1,1971 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+
+export interface paths {
+    "/v1/events": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Submit a single telemetry event
+         * @description Accepts one telemetry event per request. The payload is validated against the
+         *     anonymous-first event envelope before any storage write is attempted.
+         */
+        post: operations["ingestEvent"];
+        delete?: never;
+        /** Check browser access for telemetry ingestion */
+        options: operations["preflightIngestEvent"];
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/feedback": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Submit product feedback
+         * @description Persists one feedback submission before scheduling best-effort delivery to
+         *     the configured notification integrations. The entire JSON request body must
+         *     not exceed 8 KB.
+         */
+        post: operations["submitFeedback"];
+        delete?: never;
+        /** Check browser access for feedback submission */
+        options: operations["preflightSubmitFeedback"];
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: {
+        /**
+         * @description Single telemetry event envelope.
+         *
+         *     Anonymous mode is the default acceptance path. Identified mode is explicit and
+         *     uses a separate actor contract so later service phases can enforce stricter
+         *     rules around identified submissions.
+         *
+         *     `AnonymousEventV2` is selected by top-level `schema_version: 2`. The version 1
+         *     variants reject `schema_version` and `context`, so exactly one variant matches.
+         */
+        TelemetryEvent: components["schemas"]["AnonymousTelemetryEvent"] | components["schemas"]["IdentifiedTelemetryEvent"] | components["schemas"]["AnonymousEventV2"];
+        /**
+         * @description Schema version 2 event. Identity travels only in `context`: `actor_org_id`,
+         *     `tier`, `actor_id` and `actor_email` are not allowed, and the ingest fills the
+         *     `actor_org_id` and `tier` columns from `context.org_id` and `context.plan`.
+         *     `product`, `event` and `properties` must match a catalogued event.
+         */
+        AnonymousEventV2: components["schemas"]["EventEnvelopeV2"] & components["schemas"]["CatalogEvent"];
+        EventEnvelopeV2: {
+            /** @constant */
+            schema_version: 2;
+            context: components["schemas"]["EventContext"];
+            /** @description Product emitting the event. */
+            product: string;
+            /** @description Catalogued event name. */
+            event: string;
+            /**
+             * Format: date-time
+             * @description Event timestamp supplied by the producer.
+             */
+            occurred_at: string;
+            /** @description Emitter, such as api-server, worker, ui or live. Not the task trigger. */
+            source: string;
+            /** @constant */
+            actor_mode: "anonymous";
+            /** @description Stable anonymous installation identifier. */
+            actor_anonymous_id: string;
+            /**
+             * @description Event properties. Their schema comes from the catalog branch
+             *     (`CatalogEvent`); leaving it untyped here keeps the generated
+             *     TypeScript exact, so an unknown property fails to compile.
+             */
+            properties: unknown;
+            /** @description Transport or producer metadata that should remain queryable. */
+            metadata: {
+                [key: string]: unknown;
+            };
+        };
+        /**
+         * @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.
+         */
+        EventContext: {
+            /** @description Stored in the `actor_org_id` column. A derived self-host ID (`org_` plus 16 hex) or the cloud org ID (`org_` plus 27 alphanumerics). */
+            org_id: string;
+            org_name?: string | null;
+            /** @description Lowercase hostname of the org's email domain, without `@`. */
+            org_domain?: string | null;
+            /** @description Pseudonymous user reference. */
+            user_ref?: string | null;
+            /** @enum {string|null} */
+            user_role?: "admin" | "member" | null;
+            /** @description Stored in the `tier` column. `paid-*` is reserved. */
+            plan: string;
+            /** @enum {string} */
+            deployment: "self-host" | "cloud" | "e2b";
+            swarm_version: string;
+            install_method?: string | null;
+            install_preset?: string | null;
+            acquisition_source?: string | null;
+        };
+        EventEnvelope: {
+            /** @description Product or service emitting the telemetry event. */
+            product: string;
+            /** @description Stable event name. */
+            event: string;
+            /**
+             * Format: date-time
+             * @description Event timestamp supplied by the producer.
+             */
+            occurred_at: string;
+            /** @description Free-form source label such as cli, desktop, backend, or browser. */
+            source: string;
+            /** @description Free-form plan or installation tier. */
+            tier?: string;
+            /**
+             * @description Actor identity mode.
+             *
+             *     `anonymous` requires `actor_anonymous_id` and forbids identified-only
+             *     fields. `identified` requires `actor_id`.
+             * @enum {string}
+             */
+            actor_mode: "anonymous" | "identified";
+            /** @description Optional organization or workspace identifier. */
+            actor_org_id?: string;
+            /** @description Event-specific key-value attributes. */
+            properties: {
+                [key: string]: unknown;
+            };
+            /** @description Transport or producer metadata that should remain queryable. */
+            metadata: {
+                [key: string]: unknown;
+            };
+        };
+        AnonymousTelemetryEvent: components["schemas"]["EventEnvelope"] & {
+            /** @constant */
+            actor_mode: "anonymous";
+            /** @description Stable anonymous actor or installation identifier. */
+            actor_anonymous_id: string;
+        };
+        IdentifiedTelemetryEvent: components["schemas"]["EventEnvelope"] & {
+            /** @constant */
+            actor_mode: "identified";
+            /** @description Stable identified actor identifier. */
+            actor_id: string;
+            /** @description Optional anonymous identifier retained for continuity. */
+            actor_anonymous_id?: string;
+            /**
+             * Format: email
+             * @description Optional identified actor email for explicit identified events.
+             */
+            actor_email?: string;
+        };
+        TelemetryAcceptedResponse: {
+            /** @constant */
+            status: "accepted";
+            /** @description Optional ingestion identifier returned by the service. */
+            ingest_id?: string;
+        };
+        FeedbackSubmission: {
+            /** @description Client-generated identifier used to deduplicate submissions. */
+            submission_id: string;
+            /** @description Optional submitter name. Blank strings are treated as absent. */
+            name?: string | null;
+            /**
+             * Format: email
+             * @description Optional submitter email. Blank strings are treated as absent.
+             */
+            email?: string | null;
+            /** @description Whether the submitter explicitly consented to newsletter contact. */
+            newsletter_consent: boolean;
+            /** @description Optional rating from 1 through 5. */
+            nps?: number | null;
+            /** @description Optional feedback message. Blank strings are treated as absent. */
+            message?: string | null;
+            /** @description Stable agent-swarm user identifier. */
+            user_id: string;
+            /** @description Stable agent-swarm installation identifier. */
+            install_id: string;
+            /** @description Agent-swarm version that submitted the feedback. */
+            swarm_version: string;
+            /** @description Optional organization name. Blank strings are treated as absent. */
+            org_name?: string | null;
+            /**
+             * Format: date-time
+             * @description Optional RFC3339 installation timestamp.
+             */
+            installed_at?: string | null;
+            /**
+             * Format: date-time
+             * @description Required RFC3339 submission timestamp.
+             */
+            submitted_at: string;
+        };
+        FeedbackAcceptedResponse: {
+            /** @constant */
+            status: "accepted";
+            /** @description Identifier of the persisted feedback submission. */
+            submission_id: string;
+        };
+        /**
+         * @description 400 body for `/v1/events`. It keeps the `ProblemResponse` shape so version 1
+         *     clients that read `code` keep working. The first codes are the schema version 2
+         *     errors; the rest are the envelope checks shared with version 1.
+         */
+        IngestError: {
+            /** @enum {string} */
+            code: "invalid_json" | "unknown_field" | "unknown_event" | "unknown_property" | "invalid_property" | "missing_property" | "invalid_envelope" | "v1_sunset" | "invalid_product" | "invalid_event" | "invalid_source" | "invalid_occurred_at" | "invalid_properties" | "invalid_metadata" | "invalid_tier" | "invalid_actor_org_id" | "invalid_actor_mode" | "invalid_actor_anonymous_id" | "invalid_actor_identity" | "invalid_actor_id" | "invalid_actor_email";
+            /** @description Human-readable detail, such as the offending property name. */
+            message: string;
+        };
+        ProblemResponse: {
+            code: string;
+            message: string;
+        };
+        AgentFsLiveSessionStartedProperties: {
+            entry_route: string;
+            is_cloud: boolean;
+            version: string;
+        };
+        /** @description An agent-fs live (browser) session started. (emitter: live, since 2026-09-30) */
+        AgentFsLiveSessionStartedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "live.session_started";
+            /** @constant */
+            product: "agent-fs";
+            properties: components["schemas"]["AgentFsLiveSessionStartedProperties"];
+        };
+        AgentFsServerHeartbeatProperties: {
+            arch?: string;
+            drives?: number;
+            embedding_provider?: string;
+            files?: number;
+            is_cloud: boolean;
+            ops_total: number;
+            orgs?: number;
+            os?: string;
+            shutdown?: boolean;
+            storage_provider?: string;
+            users?: number;
+            version: string;
+        };
+        /** @description Daily agent-fs server heartbeat. v1 also sends one ops_<op> count per operation; list them before agent-fs moves to schema_version 2. (emitter: api-server, since 2026-09-30) */
+        AgentFsServerHeartbeatEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "server.heartbeat";
+            /** @constant */
+            product: "agent-fs";
+            properties: components["schemas"]["AgentFsServerHeartbeatProperties"];
+        };
+        AgentFsServerStartedProperties: {
+            arch?: string;
+            drives?: number;
+            embedding_provider?: string;
+            files?: number;
+            is_cloud: boolean;
+            orgs?: number;
+            os?: string;
+            storage_provider?: string;
+            users?: number;
+            version: string;
+        };
+        /** @description The agent-fs server started. (emitter: api-server, since 2026-09-30) */
+        AgentFsServerStartedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "server.started";
+            /** @constant */
+            product: "agent-fs";
+            properties: components["schemas"]["AgentFsServerStartedProperties"];
+        };
+        AgentFsCatalogEvent: components["schemas"]["AgentFsLiveSessionStartedEvent"] | components["schemas"]["AgentFsServerHeartbeatEvent"] | components["schemas"]["AgentFsServerStartedEvent"];
+        AgentSwarmAgentRegisteredProperties: {
+            capabilities: unknown[];
+            /** @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;
+            isReconnect: boolean;
+            /** @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;
+            role?: string;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+        };
+        /** @description An agent registered or reconnected. (emitter: api-server, since 2026-09-30) */
+        AgentSwarmAgentRegisteredEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "agent.registered";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmAgentRegisteredProperties"];
+        };
+        AgentSwarmCompactionTriggeredProperties: {
+            compactTrigger: string;
+            contextTotalTokens: number;
+            /** @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;
+            preCompactTokens: number;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+        };
+        /** @description The harness compacted a session context. (emitter: worker, since 2026-09-30) */
+        AgentSwarmCompactionTriggeredEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "compaction.triggered";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmCompactionTriggeredProperties"];
+        };
+        AgentSwarmFeatureUsedProperties: {
+            feature: 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;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+        };
+        /** @description A dashboard feature was used. (emitter: ui, since 2026-09-30) */
+        AgentSwarmFeatureUsedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "feature.used";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmFeatureUsedProperties"];
+        };
+        AgentSwarmIntegrationConnectedProperties: {
+            first_of_type: boolean;
+            /** @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;
+            provider?: string;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+            type: string;
+        };
+        /** @description An integration was connected. (emitter: api-server, since 2026-09-30) */
+        AgentSwarmIntegrationConnectedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "integration.connected";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmIntegrationConnectedProperties"];
+        };
+        AgentSwarmLeadCapturedProperties: {
+            channel: string;
+            consent: boolean;
+            /** @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;
+            submission_id: string;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+        };
+        /** @description A consented lead (Teams waitlist or private-beta sign-up). The email stays in feedback_submissions. (emitter: api-server, since 2026-09-30) */
+        AgentSwarmLeadCapturedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "lead.captured";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmLeadCapturedProperties"];
+        };
+        AgentSwarmNotificationDismissedProperties: {
+            /** @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;
+            key: string;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+        };
+        /** @description A notification-centre item was dismissed. (emitter: ui, since 2026-09-30) */
+        AgentSwarmNotificationDismissedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "notification.dismissed";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmNotificationDismissedProperties"];
+        };
+        AgentSwarmNotificationSubmittedProperties: {
+            /** @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;
+            key: string;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+        };
+        /** @description A notification-centre item was submitted. (emitter: ui, since 2026-09-30) */
+        AgentSwarmNotificationSubmittedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "notification.submitted";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmNotificationSubmittedProperties"];
+        };
+        AgentSwarmNotificationViewedProperties: {
+            /** @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;
+            key: string;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+        };
+        /** @description A notification-centre item was shown. (emitter: ui, since 2026-09-30) */
+        AgentSwarmNotificationViewedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "notification.viewed";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmNotificationViewedProperties"];
+        };
+        AgentSwarmOnboardingCompletedProperties: {
+            /** @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;
+            seconds_since_install?: number;
+            seconds_since_start: number;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+        };
+        /** @description Onboarding was completed. (emitter: api-server, since 2026-09-30) */
+        AgentSwarmOnboardingCompletedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "onboarding.completed";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmOnboardingCompletedProperties"];
+        };
+        AgentSwarmOnboardingDismissedProperties: {
+            /** @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;
+            seconds_since_install?: number;
+            seconds_since_start: number;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+        };
+        /** @description Onboarding was dismissed. (emitter: api-server, since 2026-09-30) */
+        AgentSwarmOnboardingDismissedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "onboarding.dismissed";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmOnboardingDismissedProperties"];
+        };
+        AgentSwarmOnboardingFirstTaskCompletedProperties: {
+            /** @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;
+            method?: string;
+            seconds_since_install?: number;
+            seconds_since_start: number;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+        };
+        /** @description The first task after onboarding completed. (emitter: api-server, since 2026-09-30) */
+        AgentSwarmOnboardingFirstTaskCompletedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "onboarding.first_task_completed";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmOnboardingFirstTaskCompletedProperties"];
+        };
+        AgentSwarmOnboardingStartedProperties: {
+            existing_install: boolean;
+            /** @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;
+            seconds_since_install?: number;
+            seconds_since_start: number;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+        };
+        /** @description Onboarding started. (emitter: api-server, since 2026-09-30) */
+        AgentSwarmOnboardingStartedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "onboarding.started";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmOnboardingStartedProperties"];
+        };
+        AgentSwarmOnboardingStepCompletedProperties: {
+            derived: boolean;
+            /** @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;
+            method?: string;
+            seconds_since_install?: number;
+            seconds_since_start: number;
+            step: string;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+        };
+        /** @description An onboarding step was completed. (emitter: api-server, since 2026-09-30) */
+        AgentSwarmOnboardingStepCompletedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "onboarding.step_completed";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmOnboardingStepCompletedProperties"];
+        };
+        AgentSwarmOnboardingStepFailedProperties: {
+            error_class: 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;
+            seconds_since_install?: number;
+            seconds_since_start: number;
+            step: string;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+        };
+        /** @description An onboarding step failed. (emitter: api-server, since 2026-09-30) */
+        AgentSwarmOnboardingStepFailedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "onboarding.step_failed";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmOnboardingStepFailedProperties"];
+        };
+        AgentSwarmOnboardingStepSkippedProperties: {
+            /** @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;
+            seconds_since_install?: number;
+            seconds_since_start: number;
+            step: string;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+        };
+        /** @description An onboarding step was skipped. (emitter: api-server, since 2026-09-30) */
+        AgentSwarmOnboardingStepSkippedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "onboarding.step_skipped";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmOnboardingStepSkippedProperties"];
+        };
+        AgentSwarmOnboardingStepViewedProperties: {
+            /** @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;
+            seconds_since_install?: number;
+            seconds_since_start: number;
+            step: string;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+        };
+        /** @description An onboarding step was shown. (emitter: api-server, since 2026-09-30) */
+        AgentSwarmOnboardingStepViewedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "onboarding.step_viewed";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmOnboardingStepViewedProperties"];
+        };
+        AgentSwarmOrgSnapshotProperties: {
+            /** @description Registered agents. */
+            agents_total: number;
+            /** @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 Distinct requesting users on tasks created in the last 7 days. */
+            users_active_7d: number;
+            /** @description Active users with an admin grant. */
+            users_admin: number;
+            /** @description Active users with a linked GitHub identity. */
+            users_linked_github: number;
+            /** @description Active users with a linked GitLab identity. */
+            users_linked_gitlab: number;
+            /** @description Active users with a linked Jira identity. */
+            users_linked_jira: number;
+            /** @description Active users with a linked Linear identity. */
+            users_linked_linear: number;
+            /** @description Active users with any other linked identity. */
+            users_linked_other: number;
+            /** @description Active users with a linked Slack identity. */
+            users_linked_slack: number;
+            /** @description Suspended users. */
+            users_suspended: number;
+            /** @description Active users. */
+            users_total: number;
+            /** @description Active users with an email or a live aswt_ token. */
+            users_with_login: number;
+        };
+        /** @description Daily per-install user and agent counts. Counts only: no names, emails or IDs. (emitter: api-server, since 2026-09-30) */
+        AgentSwarmOrgSnapshotEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "org.snapshot";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmOrgSnapshotProperties"];
+        };
+        AgentSwarmPageViewedProperties: {
+            /** @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 Route pattern, never the concrete URL. */
+            route_template: string;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+        };
+        /** @description A dashboard page was viewed. (emitter: ui, since 2026-09-30) */
+        AgentSwarmPageViewedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "page.viewed";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmPageViewedProperties"];
+        };
+        AgentSwarmScheduleErrorProperties: {
+            consecutiveErrors: number;
+            /** @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;
+            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 failed to fire. (emitter: api-server, since 2026-09-30) */
+        AgentSwarmScheduleErrorEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "schedule.error";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmScheduleErrorProperties"];
+        };
+        AgentSwarmScheduleExecutedProperties: {
+            /** @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;
+            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 discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "schedule.executed";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmScheduleExecutedProperties"];
+        };
+        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;
+            durationMs: number;
+            /** @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;
+            inputTokens: number;
+            /** @description Legacy key kept during the v1 window; v2 carries context.install_method. */
+            install_method?: string;
+            isError: boolean;
+            /** @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;
+            numTurns: number | null;
+            outputTokens: number;
+            provider: string;
+            reasoningOutputTokens?: number;
+            /** @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;
+            thinkingTokens?: number;
+            totalCostUsd: number;
+            /** @description Root surface of the task, or null for a session with no task. */
+            trigger_surface: components["schemas"]["TriggerSurface"] | null;
+        };
+        /** @description Token usage and cost of one session. (emitter: worker, since 2026-09-30) */
+        AgentSwarmSessionCostEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "session.cost";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmSessionCostProperties"];
+        };
+        AgentSwarmSessionEndedProperties: {
+            agentId: string;
+            durationMs?: number;
+            /** @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 Task the session ran, or null for a session with no task. */
+            taskId: string | null;
+            tasksProcessed: number;
+            /** @description Root surface of the task, or null for a session with no task. */
+            trigger_surface: components["schemas"]["TriggerSurface"] | null;
+        };
+        /** @description A worker or lead session ended. (emitter: worker, since 2026-09-30) */
+        AgentSwarmSessionEndedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "session.ended";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmSessionEndedProperties"];
+        };
+        AgentSwarmSessionFailureProperties: {
+            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 failed. (emitter: worker, since 2026-09-30) */
+        AgentSwarmSessionFailureEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "session.failure";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmSessionFailureProperties"];
+        };
+        AgentSwarmSessionStartedProperties: {
+            agentId: string;
+            harnessProvider: 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;
+            role: 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;
+        };
+        /** @description A worker or lead session started. (emitter: worker, since 2026-09-30) */
+        AgentSwarmSessionStartedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "session.started";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmSessionStartedProperties"];
+        };
+        AgentSwarmSessionSteeredProperties: {
+            by_kind: 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;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+            /** @description Root surface of the steered task, or null when unknown. */
+            trigger_surface: components["schemas"]["TriggerSurface"] | null;
+        };
+        /** @description A running session received a steering message. (emitter: api-server, since 2026-09-30) */
+        AgentSwarmSessionSteeredEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "session.steered";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmSessionSteeredProperties"];
+        };
+        AgentSwarmSkillInvokedProperties: {
+            /** @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;
+            skill_name: string;
+            skill_source: string;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+            /** @description Root surface of the task, or null for a session with no task. */
+            trigger_surface: components["schemas"]["TriggerSurface"] | null;
+        };
+        /** @description A skill was invoked in a session. (emitter: worker, since 2026-09-30) */
+        AgentSwarmSkillInvokedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "skill.invoked";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmSkillInvokedProperties"];
+        };
+        AgentSwarmTaskCancelledProperties: {
+            agentId?: string;
+            durationMs?: number;
+            /** @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;
+            previousStatus: string;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+            taskId: string;
+            /** @description agent_tasks.source of this task itself. */
+            task_source: components["schemas"]["TriggerSurface"];
+            /** @description Surface that started the whole chain of work: the source of the root task. */
+            trigger_surface: components["schemas"]["TriggerSurface"];
+        };
+        /** @description A task was cancelled. (emitter: api-server, since 2026-09-30) */
+        AgentSwarmTaskCancelledEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "task.cancelled";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmTaskCancelledProperties"];
+        };
+        AgentSwarmTaskClaimedProperties: {
+            agentId: 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;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+            taskId: string;
+            /** @description agent_tasks.source of this task itself. */
+            task_source: components["schemas"]["TriggerSurface"];
+            /** @description Surface that started the whole chain of work: the source of the root task. */
+            trigger_surface: components["schemas"]["TriggerSurface"];
+        };
+        /** @description An agent claimed a task. (emitter: api-server, since 2026-09-30) */
+        AgentSwarmTaskClaimedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "task.claimed";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmTaskClaimedProperties"];
+        };
+        AgentSwarmTaskCompletedProperties: {
+            agentId?: string;
+            durationMs?: number;
+            harnessVariant?: string;
+            harnessVersion?: 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;
+            provider?: string;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+            taskId: string;
+            /** @description agent_tasks.source of this task itself. */
+            task_source: components["schemas"]["TriggerSurface"];
+            /** @description Surface that started the whole chain of work: the source of the root task. */
+            trigger_surface: components["schemas"]["TriggerSurface"];
+        };
+        /** @description A task completed. (emitter: api-server, since 2026-09-30) */
+        AgentSwarmTaskCompletedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "task.completed";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmTaskCompletedProperties"];
+        };
+        AgentSwarmTaskCreatedProperties: {
+            harnessVariant?: string;
+            harnessVersion?: string;
+            hasParent: boolean;
+            /** @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;
+            has_repo: 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;
+            priority: number;
+            provider?: string;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+            taskId: string;
+            /** @description agent_tasks.source of this task itself. */
+            task_source: components["schemas"]["TriggerSurface"];
+            /** @description Surface that started the whole chain of work: the source of the root task. */
+            trigger_surface: components["schemas"]["TriggerSurface"];
+        };
+        /** @description A task was created. (emitter: api-server, since 2026-09-30) */
+        AgentSwarmTaskCreatedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "task.created";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmTaskCreatedProperties"];
+        };
+        AgentSwarmTaskFailedProperties: {
+            agentId?: string;
+            durationMs?: number;
+            harnessVariant?: string;
+            harnessVersion?: 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;
+            provider?: string;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+            taskId: string;
+            /** @description agent_tasks.source of this task itself. */
+            task_source: components["schemas"]["TriggerSurface"];
+            /** @description Surface that started the whole chain of work: the source of the root task. */
+            trigger_surface: components["schemas"]["TriggerSurface"];
+        };
+        /** @description A task failed. (emitter: api-server, since 2026-09-30) */
+        AgentSwarmTaskFailedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "task.failed";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmTaskFailedProperties"];
+        };
+        AgentSwarmTaskSessionCompletedProperties: {
+            agentId: string;
+            durationMs: number;
+            exitCode: number;
+            harnessVariant?: string;
+            harnessVersion?: 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;
+            isError: boolean;
+            /** @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;
+        };
+        /** @description A worker session for a task finished. (emitter: worker, since 2026-09-30) */
+        AgentSwarmTaskSessionCompletedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "task.session_completed";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmTaskSessionCompletedProperties"];
+        };
+        AgentSwarmTaskStartedProperties: {
+            agentId: 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;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+            taskId: string;
+            /** @description agent_tasks.source of this task itself. */
+            task_source: components["schemas"]["TriggerSurface"];
+            /** @description Surface that started the whole chain of work: the source of the root task. */
+            trigger_surface: components["schemas"]["TriggerSurface"];
+        };
+        /** @description A task started running. (emitter: api-server, since 2026-09-30) */
+        AgentSwarmTaskStartedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "task.started";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmTaskStartedProperties"];
+        };
+        AgentSwarmTaskSupersededProperties: {
+            agentId?: string;
+            durationMs?: number;
+            harnessVariant?: string;
+            harnessVersion?: 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;
+            provider?: string;
+            reason: string;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+            taskId: string;
+            /** @description agent_tasks.source of this task itself. */
+            task_source: components["schemas"]["TriggerSurface"];
+            /** @description Surface that started the whole chain of work: the source of the root task. */
+            trigger_surface: components["schemas"]["TriggerSurface"];
+        };
+        /** @description A task was superseded by another task. (emitter: api-server, since 2026-09-30) */
+        AgentSwarmTaskSupersededEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "task.superseded";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmTaskSupersededProperties"];
+        };
+        AgentSwarmUiSessionStartedProperties: {
+            /** @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 A dashboard session started. (emitter: ui, since 2026-09-30) */
+        AgentSwarmUiSessionStartedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "ui.session_started";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmUiSessionStartedProperties"];
+        };
+        AgentSwarmWorkflowCompletedProperties: {
+            durationMs?: number;
+            /** @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;
+            stepsCompleted: number;
+            stepsFailed: number;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+            workflowId: string;
+        };
+        /** @description A workflow run completed. (emitter: api-server, since 2026-09-30) */
+        AgentSwarmWorkflowCompletedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "workflow.completed";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmWorkflowCompletedProperties"];
+        };
+        AgentSwarmWorkflowCreatedProperties: {
+            /** @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;
+            nodeCount: number;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+            /**
+             * @description Interface that created the workflow. Sent as the property source in v1.
+             * @enum {string}
+             */
+            via?: "api" | "mcp";
+            workflowId: string;
+        };
+        /** @description A workflow was created. (emitter: api-server, since 2026-09-30) */
+        AgentSwarmWorkflowCreatedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "workflow.created";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmWorkflowCreatedProperties"];
+        };
+        AgentSwarmWorkflowDeletedProperties: {
+            /** @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 Interface that deleted the workflow. Sent as the property source in v1.
+             * @enum {string}
+             */
+            via?: "api" | "mcp";
+            workflowId: string;
+        };
+        /** @description A workflow was deleted. (emitter: api-server, since 2026-09-30) */
+        AgentSwarmWorkflowDeletedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "workflow.deleted";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmWorkflowDeletedProperties"];
+        };
+        AgentSwarmWorkflowFailedProperties: {
+            durationMs?: number;
+            /** @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;
+            stepsCompleted: number;
+            stepsFailed: number;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+            workflowId: string;
+        };
+        /** @description A workflow run failed. (emitter: api-server, since 2026-09-30) */
+        AgentSwarmWorkflowFailedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "workflow.failed";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmWorkflowFailedProperties"];
+        };
+        AgentSwarmWorkflowStartedProperties: {
+            /** @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;
+            nodeCount: number;
+            /** @description agent-swarm version. Legacy key kept during the v1 window; v2 carries context.swarm_version. */
+            swarmVersion?: string;
+            triggerType: string;
+            workflowId: string;
+        };
+        /** @description A workflow run started. (emitter: api-server, since 2026-09-30) */
+        AgentSwarmWorkflowStartedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            event: "workflow.started";
+            /** @constant */
+            product: "agent-swarm";
+            properties: components["schemas"]["AgentSwarmWorkflowStartedProperties"];
+        };
+        AgentSwarmCatalogEvent: components["schemas"]["AgentSwarmAgentRegisteredEvent"] | components["schemas"]["AgentSwarmCompactionTriggeredEvent"] | components["schemas"]["AgentSwarmFeatureUsedEvent"] | 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"]["AgentSwarmOrgSnapshotEvent"] | components["schemas"]["AgentSwarmPageViewedEvent"] | 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"]["AgentSwarmUiSessionStartedEvent"] | 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"];
+    };
+    responses: {
+        /** @description Browser preflight response. CORS allow headers are present only for an allowed origin. */
+        CORSPreflightResponse: {
+            headers: {
+                /** @description The allowed request Origin, reflected exactly. */
+                "Access-Control-Allow-Origin"?: string;
+                "Access-Control-Allow-Methods"?: "POST, OPTIONS";
+                "Access-Control-Allow-Headers"?: "Content-Type, X-Telemetry-Identified-Token";
+                "Access-Control-Max-Age"?: "86400";
+                Vary?: "Origin";
+                [name: string]: unknown;
+            };
+            content?: never;
+        };
+    };
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export interface operations {
+    ingestEvent: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["TelemetryEvent"];
+            };
+        };
+        responses: {
+            /** @description Event accepted for ingestion. */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TelemetryAcceptedResponse"];
+                };
+            };
+            /**
+             * @description Request body failed validation. Every 400 is also recorded in the
+             *     `rejected_events` table.
+             */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["IngestError"];
+                };
+            };
+            /** @description Identified event submission is not authorized for this request. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemResponse"];
+                };
+            };
+            /**
+             * @description Request body exceeds 1 MB (code `body_too_large`). The first 8 KB are
+             *     recorded in the `rejected_events` table.
+             */
+            413: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemResponse"];
+                };
+            };
+        };
+    };
+    preflightIngestEvent: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            204: components["responses"]["CORSPreflightResponse"];
+        };
+    };
+    submitFeedback: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["FeedbackSubmission"];
+            };
+        };
+        responses: {
+            /** @description Feedback persisted and accepted for asynchronous delivery. */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FeedbackAcceptedResponse"];
+                };
+            };
+            /** @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 8 KB. */
+            413: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemResponse"];
+                };
+            };
+            /** @description The source IP exceeded the feedback submission rate limit. */
+            429: {
+                headers: {
+                    /** @description Seconds to wait before retrying. */
+                    "Retry-After"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemResponse"];
+                };
+            };
+            /** @description The feedback submission could not be persisted. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemResponse"];
+                };
+            };
+            /** @description Feedback storage is not configured. */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemResponse"];
+                };
+            };
+        };
+    };
+    preflightSubmitFeedback: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            204: components["responses"]["CORSPreflightResponse"];
+        };
+    };
+}