@desplega.ai/agent-swarm 2.4.0 → 2.4.1

package/src/telemetry-context.ts

@@ -9,6 +9,12 @@
 import { createHash, randomBytes } from "node:crypto";
 import { type EventContext, TRIGGER_SURFACES, type TriggerSurface } from "./telemetry-contract";
 import catalog from "./telemetry-contract/catalog.json";
+import {
+  COMPANY_ACQUISITION_SOURCES,
+  COMPANY_TEAM_SIZES,
+  COMPANY_USE_CASES,
+  USER_FUNCTIONS,
+} from "./utils/company-profile";
 
 /** `org_` + 16 lowercase hex (self-host, minted here) or 27 alphanumerics (cloud). Same pattern the proxy enforces. */
 const ORG_ID_PATTERN = /^org_([0-9a-f]{16}|[A-Za-z0-9]{27})$/;
@@ -97,6 +103,9 @@ export interface ContextInput {
   installMethod?: string | null;
   installPreset?: string | null;
   acquisitionSource?: string | null;
+  teamSize?: string | null;
+  useCase?: string | null;
+  userFunction?: string | null;
 }
 
 /** Build the top-level `context` object of a schema_version 2 event. */
@@ -105,6 +114,11 @@ export function buildContext(input: ContextInput): EventContext {
   const orgName = input.orgName?.trim();
   const orgDomain = validOrgDomain(input.orgDomain);
   const orgWebsite = validOrgDomain(input.orgWebsite);
+  const teamSize = COMPANY_TEAM_SIZES.find((value) => value === input.teamSize);
+  const useCase = COMPANY_USE_CASES.find((value) => value === input.useCase);
+  const userFunction = userId
+    ? USER_FUNCTIONS.find((value) => value === input.userFunction)
+    : undefined;
   return {
     org_id: input.orgId,
     org_name: orgName ? orgName : null,
@@ -116,10 +130,14 @@ export function buildContext(input: ContextInput): EventContext {
     swarm_version: input.swarmVersion,
     install_method: input.installMethod ?? null,
     install_preset: input.installPreset ?? null,
-    acquisition_source: input.acquisitionSource ?? null,
+    acquisition_source:
+      COMPANY_ACQUISITION_SOURCES.find((value) => value === input.acquisitionSource) ?? null,
     // Optional in the catalog: left out, not null, when unset, so an ingest
     // that predates the field keeps accepting events from installs without one.
     ...(orgWebsite ? { org_website: orgWebsite } : {}),
+    ...(teamSize ? { team_size: teamSize } : {}),
+    ...(useCase ? { use_case: useCase } : {}),
+    ...(userFunction ? { user_function: userFunction } : {}),
   };
 }
 

package/src/telemetry-contract/EVENTS.md

@@ -4,18 +4,48 @@
 
 Every event the ingest accepts with `schema_version: 2`. A v2 event that is not listed here, or that sends a property not listed for it, is rejected with a typed 400. `Emitter` is the envelope `source`.
 
+## `acquisition_source`
+
+How the organization found Agent Swarm.
+
+Values: `search`, `github`, `social`, `colleague`, `newsletter`, `event`, `ai_assistant`, `hacker_news`, `other`.
+
+## `notification_moment`
+
+Moment that made the Slack Connect invite relevant.
+
+Values: `task_failed`, `first_workflow`, `default`.
+
 ## `popup`
 
 Dashboard pop-up that a popup.* event is about.
 
 Values: `feedback`, `org_name`, `used_by`.
 
+## `team_size`
+
+Size of the organization team.
+
+Values: `1`, `2-10`, `11-50`, `51+`.
+
 ## `trigger_surface`
 
 Surface that started a chain of work: agent-swarm's AgentTaskSourceSchema values plus other.
 
 Values: `slack`, `ui`, `api`, `mcp`, `github`, `gitlab`, `linear`, `jira`, `agentmail`, `schedule`, `workflow`, `system`, `other`.
 
+## `use_case`
+
+Primary use of the swarm.
+
+Values: `features`, `bugs`, `review`, `ops`, `docs`, `data`.
+
+## `user_function`
+
+Job function of a user, separate from the RBAC user_role.
+
+Values: `engineer`, `eng_lead`, `founder`, `product`, `ops`, `other`.
+
 ## `agent-fs`
 
 | Event | Emitter | Since | Description | Properties |
@@ -44,12 +74,15 @@ Common properties, allowed on every event of this product:
 | `agent.registered` | api-server | 2026-09-30 | An agent registered or reconnected. | `capabilities` (array, required)<br>`isReconnect` (boolean, required)<br>`role` (string) |
 | `compaction.triggered` | worker | 2026-09-30 | The harness compacted a session context. | `compactTrigger` (string, required)<br>`contextTotalTokens` (integer, required)<br>`preCompactTokens` (integer, required) |
 | `feature.used` | ui | 2026-09-30 | A dashboard feature was used. | `feature` (string, required) |
-| `fleet_benchmark.viewed` | ui | 2026-10-12 | The fleet benchmark card was shown. | `has_org_name` (boolean, required) |
+| `fleet_benchmark.unlocked` | ui | 2026-10-18 | An admin supplied the company profile fields for the full benchmark. | `fields` (array of website \| team_size \| use_case, required) |
+| `fleet_benchmark.viewed` | ui | 2026-10-12 | The fleet benchmark card was shown. | `has_org_name` (boolean, required)<br>`level` (basic \| full) |
+| `identity.lookup` | ui | 2026-10-18 | A dashboard identity lookup matched an existing user or found no match. | `matched` (boolean, required) |
+| `identity.user_created` | ui | 2026-10-18 | A user created a dashboard identity. Email and personal names stay out of telemetry. | `email_kind` (work \| personal, required)<br>`has_company` (boolean, required)<br>`has_function` (boolean, required)<br>`surface` (identity_modal \| setup, required) |
 | `integration.connected` | api-server | 2026-09-30 | An integration was connected. | `first_of_type` (boolean, required)<br>`provider` (string)<br>`type` (string, required) |
 | `lead.captured` | api-server | 2026-09-30 | A consented lead (Teams waitlist or private-beta sign-up). The email stays in feedback_submissions. | `channel` (string, required)<br>`consent` (boolean, required)<br>`submission_id` (string, required) |
-| `notification.dismissed` | ui | 2026-09-30 | A notification-centre item was dismissed. | `key` (string, required) |
-| `notification.submitted` | ui | 2026-09-30 | A notification-centre item was submitted. | `email_domain` (string)<br>`key` (string, required) |
-| `notification.viewed` | ui | 2026-09-30 | A notification-centre item was shown. | `key` (string, required) |
+| `notification.dismissed` | ui | 2026-09-30 | A notification-centre item was dismissed. | `key` (string, required)<br>`moment` (task_failed \| first_workflow \| default) |
+| `notification.submitted` | ui | 2026-09-30 | A notification-centre item was submitted. | `email_domain` (string)<br>`key` (string, required)<br>`moment` (task_failed \| first_workflow \| default)<br>`user_function` (engineer \| eng_lead \| founder \| product \| ops \| other) |
+| `notification.viewed` | ui | 2026-09-30 | A notification-centre item was shown. | `key` (string, required)<br>`moment` (task_failed \| first_workflow \| default) |
 | `onboarding.completed` | api-server | 2026-09-30 | Onboarding was completed. | `seconds_since_install` (integer)<br>`seconds_since_start` (integer, required) |
 | `onboarding.dismissed` | api-server | 2026-09-30 | Onboarding was dismissed. | `seconds_since_install` (integer)<br>`seconds_since_start` (integer, required) |
 | `onboarding.first_task_completed` | api-server | 2026-09-30 | The first task after onboarding completed. | `method` (string)<br>`seconds_since_install` (integer)<br>`seconds_since_start` (integer, required) |
@@ -58,12 +91,12 @@ Common properties, allowed on every event of this product:
 | `onboarding.step_failed` | api-server | 2026-09-30 | An onboarding step failed. | `error_class` (string, required)<br>`seconds_since_install` (integer)<br>`seconds_since_start` (integer, required)<br>`step` (string, required) |
 | `onboarding.step_skipped` | api-server | 2026-09-30 | An onboarding step was skipped. | `seconds_since_install` (integer)<br>`seconds_since_start` (integer, required)<br>`step` (string, required) |
 | `onboarding.step_viewed` | api-server | 2026-09-30 | An onboarding step was shown. | `seconds_since_install` (integer)<br>`seconds_since_start` (integer, required)<br>`step` (string, required) |
-| `org.profile_updated` | ui | 2026-10-12 | An admin changed the org profile. Lists which fields changed, never their values. | `fields` (array, required)<br>`surface` (prompt \| setup \| settings, required) |
+| `org.profile_updated` | ui | 2026-10-12 | An admin changed the org profile. Lists which fields changed, never their values. | `fields` (array of name \| website \| team_size \| use_case \| acquisition_source, required)<br>`surface` (enum, required) |
 | `org.snapshot` | api-server | 2026-09-30 | Daily per-install user and agent counts. Counts only: no names, emails or IDs. | `agents_total` (integer ≥0, required)<br>`users_active_7d` (integer ≥0, required)<br>`users_admin` (integer ≥0, required)<br>`users_linked_github` (integer ≥0, required)<br>`users_linked_gitlab` (integer ≥0, required)<br>`users_linked_jira` (integer ≥0, required)<br>`users_linked_linear` (integer ≥0, required)<br>`users_linked_other` (integer ≥0, required)<br>`users_linked_slack` (integer ≥0, required)<br>`users_suspended` (integer ≥0, required)<br>`users_total` (integer ≥0, required)<br>`users_with_login` (integer ≥0, required) |
 | `page.viewed` | ui | 2026-09-30 | A dashboard page was viewed. | `route_template` (string, required) |
 | `popup.dismissed` | ui | 2026-10-12 | A dashboard pop-up was closed without submitting. | `method` (later \| close \| escape, required)<br>`popup` (feedback \| org_name \| used_by, required) |
 | `popup.shown` | ui | 2026-10-12 | A dashboard pop-up was shown. Telemetry-gated: never sent while telemetry is off. | `popup` (feedback \| org_name \| used_by, required)<br>`trigger` (task_failed \| tasks_completed \| workflow_completed \| quarterly \| missing_org_name, required) |
-| `popup.submitted` | ui | 2026-10-12 | A dashboard pop-up was submitted. Content stays out of telemetry: only flags for what was filled. | `has_contact` (boolean, required)<br>`has_message` (boolean, required)<br>`popup` (feedback \| org_name \| used_by, required)<br>`score` (integer ≥0) |
+| `popup.submitted` | ui | 2026-10-12 | A dashboard pop-up was submitted. Content stays out of telemetry: only flags for what was filled. | `answered` (integer ≥0)<br>`has_contact` (boolean, required)<br>`has_message` (boolean, required)<br>`perks` (array of used_by \| slack_connect)<br>`popup` (feedback \| org_name \| used_by, required)<br>`score` (integer ≥0) |
 | `ranking.opted_in` | api-server | 2026-10-18 | An admin opted the install into the public ranking, or the API rebuilt its listing after an org identity change. | `listing` (string, required) |
 | `ranking.opted_out` | api-server | 2026-10-18 | The install left the public ranking: the admin turned it off, or the org name or website was cleared or changed. | `domain` (string, required) |
 | `ranking.usage` | worker | 2026-10-18 | Token usage of one session on an install opted into the public ranking. Sent next to session.cost. | `cacheReadTokens` (integer ≥0)<br>`cacheWriteTokens` (integer ≥0)<br>`inputTokens` (integer ≥0, required)<br>`model` (string)<br>`outputTokens` (integer ≥0, required)<br>`provider` (string)<br>`totalTokens` (integer ≥0, required) |
@@ -77,6 +110,7 @@ Common properties, allowed on every event of this product:
 | `session.failure` | worker | 2026-09-30 | A session failed. | `agentId` (string, required)<br>`durationMs` (integer, required)<br>`errorCategory` (string, required)<br>`model` (string, required)<br>`provider` (string, required)<br>`taskId` (string, nullable, required)<br>`trigger_surface` (enum, nullable, required)<br>`wasRateLimited` (boolean, required) |
 | `session.started` | worker | 2026-09-30 | A worker or lead session started. | `agentId` (string, required)<br>`harnessProvider` (string, required)<br>`model` (string)<br>`role` (string, required)<br>`taskId` (string, nullable, required)<br>`trigger_surface` (enum, nullable, required) |
 | `session.steered` | api-server | 2026-09-30 | A running session received a steering message. | `by_kind` (string, required)<br>`trigger_surface` (enum, nullable, required) |
+| `setup.worker_command_copied` | ui | 2026-10-18 | An admin copied a worker command from the setup health popover. | `harness` (enum, required)<br>`target` (compose \| docker \| kubernetes, required) |
 | `skill.invoked` | worker | 2026-09-30 | A skill was invoked in a session. | `skill_name` (string, required)<br>`skill_source` (string, required)<br>`trigger_surface` (enum, nullable, required) |
 | `task.cancelled` | api-server | 2026-09-30 | A task was cancelled. | `agentId` (string)<br>`durationMs` (integer)<br>`previousStatus` (string, required)<br>`taskId` (string, required)<br>`task_source` (enum, required)<br>`trigger_surface` (enum, required) |
 | `task.claimed` | api-server | 2026-09-30 | An agent claimed a task. | `agentId` (string, required)<br>`taskId` (string, required)<br>`task_source` (enum, required)<br>`trigger_surface` (enum, required) |
@@ -86,9 +120,9 @@ Common properties, allowed on every event of this product:
 | `task.session_completed` | worker | 2026-09-30 | A worker session for a task finished. | `agentId` (string, required)<br>`durationMs` (integer, required)<br>`exitCode` (integer, required)<br>`harnessVariant` (string)<br>`harnessVersion` (string)<br>`isError` (boolean, required)<br>`model` (string, required)<br>`provider` (string, required)<br>`taskId` (string, nullable, required)<br>`trigger_surface` (enum, nullable, required) |
 | `task.started` | api-server | 2026-09-30 | A task started running. | `agentId` (string, required)<br>`taskId` (string, required)<br>`task_source` (enum, required)<br>`trigger_surface` (enum, required) |
 | `task.superseded` | api-server | 2026-09-30 | A task was superseded by another task. | `agentId` (string)<br>`durationMs` (integer)<br>`harnessVariant` (string)<br>`harnessVersion` (string)<br>`provider` (string)<br>`reason` (string, required)<br>`taskId` (string, required)<br>`task_source` (enum, required)<br>`trigger_surface` (enum, required) |
-| `telemetry.enabled` | api-server | 2026-10-12 | Telemetry was turned on. Sent once, on the first boot or re-init after opting in. | `via` (banner \| settings \| env, required) |
+| `telemetry.enabled` | api-server | 2026-10-12 | Telemetry was turned on. Sent once, on the first boot or re-init after opting in. | `via` (banner \| settings \| env \| benchmark, required) |
 | `ui.session_started` | ui | 2026-09-30 | A dashboard session started. | none |
-| `used_by.consent_changed` | ui | 2026-10-12 | An admin granted or revoked the "used by" logo consent. The request itself goes to /v1/used-by. | `granted` (boolean, required) |
+| `used_by.consent_changed` | ui | 2026-10-12 | An admin granted or revoked the "used by" logo consent. The request itself goes to /v1/used-by. | `granted` (boolean, required)<br>`has_function` (boolean)<br>`has_quote` (boolean) |
 | `workflow.completed` | api-server | 2026-09-30 | A workflow run completed. | `durationMs` (integer)<br>`stepsCompleted` (integer, required)<br>`stepsFailed` (integer, required)<br>`workflowId` (string, required) |
 | `workflow.created` | api-server | 2026-09-30 | A workflow was created. | `nodeCount` (integer, required)<br>`via` (api \| mcp)<br>`workflowId` (string, required) |
 | `workflow.deleted` | api-server | 2026-09-30 | A workflow was deleted. | `via` (api \| mcp)<br>`workflowId` (string, required) |

package/src/telemetry-contract/SOURCE.json

@@ -1,10 +1,10 @@
 {
   "repo": "desplega-ai/proxy",
-  "commit": "6260f39827fc57784642b1adc88a43f61d882a6f",
+  "commit": "cc593585467a920dcb8731993d092639372dc7af",
   "files": {
-    "types.gen.ts": "192c6769164a65b6e804ea088b38de6827d34fac26a7ecaccce881a46e98b1a7",
-    "catalog.json": "1b2b052f8e43f082e9d6efc2768752d6f194c0cbf0d26ae9c35643cce0e6486c",
-    "EVENTS.md": "9451da995ef04a049888715f960a1641bbc52fecb3dce97610c3c391bead1faf",
+    "types.gen.ts": "aa8a682f1d875515d63cf5bd3fa667dcb06cd851f8b2b798482a4c71cd775444",
+    "catalog.json": "595654f288ae2a7cbb265b6b2a72392acc33f5acde365d72829101912525a891",
+    "EVENTS.md": "51ee5491c633d684b163d727a369a08b5c1d3f4ba453277d840526449a0bad0c",
     "ranking/fixtures/expected.json": "6d506546f48d99a089666bed2a4c08752ebb63a029392c76ffd057e9520adc70",
     "ranking/fixtures/invalid/bad-category.json": "a4c36da6079c36d15e5e8c8e6322fc97b172de015a80a26cee8cab699f666236",
     "ranking/fixtures/invalid/bad-claim.json": "cee14d465545d057cfb61922301a5119187ba17d70efabb16528a5e305d7b065",
@@ -34,9 +34,10 @@
     "ranking/fixtures/valid/category-without-subcategory.json": "45c5b872aec232bdcba791e6ba1a7aba698c825f389e194a38e96ad141f56e5a",
     "ranking/fixtures/valid/full.json": "d6d93c4a6159e814c3f089c69083df700fb19359f127ccd2b71529a058dfe5e9",
     "ranking/fixtures/valid/minimal.json": "de6629d6ee2c4b67598abfc5ec7f6470a93dd9893b07e6e7c93d018cf5445593",
+    "ranking/fixtures/valid/no-claim.json": "fa5c08ec50c1b602f404cf36ce8b1c03d131111379d914699378dd448431cb84",
     "ranking/fixtures/valid/padded-text.json": "db71248bf83bb1ffb639208ec467a0228e5c37f604299d09838ab25dc61986a3",
     "ranking/fixtures/valid/unicode-name.json": "01a9d2cc8c5fec128af3eef35bf16696286f28636dac21b9dec107b28fddf743",
-    "ranking/listing.v1.schema.json": "1895c57075bbb4b0945e1c5daf813d6c4eaccf1f4480cabd6dc0ce2f0d146776",
+    "ranking/listing.v1.schema.json": "f839b669abadb25e031515a5cc2abd3aa2024e85e6117cae83133fc9dfbb769d",
     "ranking/taxonomy.json": "c6abe7e437635c9a3c1a82a3477a8757ba6c0cb7cbeae86c8c3d175fb37f402c"
   }
 }

package/src/telemetry-contract/catalog.json

@@ -27,6 +27,64 @@
         "org_name",
         "used_by"
       ]
+    },
+    "team_size": {
+      "type": "string",
+      "description": "Size of the organization team.",
+      "enum": [
+        "1",
+        "2-10",
+        "11-50",
+        "51+"
+      ]
+    },
+    "use_case": {
+      "type": "string",
+      "description": "Primary use of the swarm.",
+      "enum": [
+        "features",
+        "bugs",
+        "review",
+        "ops",
+        "docs",
+        "data"
+      ]
+    },
+    "acquisition_source": {
+      "type": "string",
+      "description": "How the organization found Agent Swarm.",
+      "enum": [
+        "search",
+        "github",
+        "social",
+        "colleague",
+        "newsletter",
+        "event",
+        "ai_assistant",
+        "hacker_news",
+        "other"
+      ]
+    },
+    "user_function": {
+      "type": "string",
+      "description": "Job function of a user, separate from the RBAC user_role.",
+      "enum": [
+        "engineer",
+        "eng_lead",
+        "founder",
+        "product",
+        "ops",
+        "other"
+      ]
+    },
+    "notification_moment": {
+      "type": "string",
+      "description": "Moment that made the Slack Connect invite relevant.",
+      "enum": [
+        "task_failed",
+        "first_workflow",
+        "default"
+      ]
     }
   },
   "common_properties": {
@@ -1125,6 +1183,9 @@
         "key": {
           "type": "string",
           "required": true
+        },
+        "moment": {
+          "ref": "notification_moment"
         }
       }
     },
@@ -1138,6 +1199,9 @@
         "key": {
           "type": "string",
           "required": true
+        },
+        "moment": {
+          "ref": "notification_moment"
         }
       }
     },
@@ -1155,6 +1219,12 @@
         "email_domain": {
           "type": "string",
           "description": "Domain of the email typed into the item, never the address."
+        },
+        "moment": {
+          "ref": "notification_moment"
+        },
+        "user_function": {
+          "ref": "user_function"
         }
       }
     },
@@ -1167,7 +1237,8 @@
       "properties": {
         "feature": {
           "type": "string",
-          "required": true
+          "required": true,
+          "description": "Feature identifier, including health_popover and kickoff_call_opened. Existing identifiers remain accepted."
         }
       }
     },
@@ -1222,7 +1293,8 @@
       "properties": {
         "channel": {
           "type": "string",
-          "required": true
+          "required": true,
+          "description": "Lead channel, including setup_help and fleet_report. Existing channels remain accepted."
         },
         "submission_id": {
           "type": "string",
@@ -1305,6 +1377,22 @@
           "type": "boolean",
           "required": true,
           "description": "A name or email was left. The values go to /v1/feedback, never here."
+        },
+        "answered": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Number of profile follow-up questions answered, never their values."
+        },
+        "perks": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "used_by",
+              "slack_connect"
+            ]
+          },
+          "description": "Perks the admin explicitly selected."
         }
       }
     },
@@ -1317,8 +1405,18 @@
       "properties": {
         "fields": {
           "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "name",
+              "website",
+              "team_size",
+              "use_case",
+              "acquisition_source"
+            ]
+          },
           "required": true,
-          "description": "Changed field names: name, website."
+          "description": "Changed profile field names, never their values."
         },
         "surface": {
           "type": "string",
@@ -1326,7 +1424,12 @@
           "enum": [
             "prompt",
             "setup",
-            "settings"
+            "settings",
+            "org_name_popup",
+            "feedback",
+            "fleet_benchmark",
+            "telemetry_banner",
+            "identity_modal"
           ],
           "description": "Where the change was made. Not trigger_surface: that key fills the raw_events.trigger_surface column."
         }
@@ -1342,6 +1445,12 @@
         "granted": {
           "type": "boolean",
           "required": true
+        },
+        "has_quote": {
+          "type": "boolean"
+        },
+        "has_function": {
+          "type": "boolean"
         }
       }
     },
@@ -1358,7 +1467,8 @@
           "enum": [
             "banner",
             "settings",
-            "env"
+            "env",
+            "benchmark"
           ]
         }
       }
@@ -1373,6 +1483,13 @@
         "has_org_name": {
           "type": "boolean",
           "required": true
+        },
+        "level": {
+          "type": "string",
+          "enum": [
+            "basic",
+            "full"
+          ]
         }
       }
     },
@@ -1554,6 +1671,109 @@
           "required": true
         }
       }
+    },
+    {
+      "product": "agent-swarm",
+      "event": "identity.lookup",
+      "description": "A dashboard identity lookup matched an existing user or found no match.",
+      "since": "2026-10-18",
+      "source": "ui",
+      "properties": {
+        "matched": {
+          "type": "boolean",
+          "required": true
+        }
+      }
+    },
+    {
+      "product": "agent-swarm",
+      "event": "identity.user_created",
+      "description": "A user created a dashboard identity. Email and personal names stay out of telemetry.",
+      "since": "2026-10-18",
+      "source": "ui",
+      "properties": {
+        "surface": {
+          "type": "string",
+          "required": true,
+          "enum": [
+            "identity_modal",
+            "setup"
+          ]
+        },
+        "email_kind": {
+          "type": "string",
+          "required": true,
+          "enum": [
+            "work",
+            "personal"
+          ]
+        },
+        "has_function": {
+          "type": "boolean",
+          "required": true
+        },
+        "has_company": {
+          "type": "boolean",
+          "required": true
+        }
+      }
+    },
+    {
+      "product": "agent-swarm",
+      "event": "fleet_benchmark.unlocked",
+      "description": "An admin supplied the company profile fields for the full benchmark.",
+      "since": "2026-10-18",
+      "source": "ui",
+      "properties": {
+        "fields": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "website",
+              "team_size",
+              "use_case"
+            ]
+          },
+          "required": true,
+          "description": "Profile fields supplied, never their values."
+        }
+      }
+    },
+    {
+      "product": "agent-swarm",
+      "event": "setup.worker_command_copied",
+      "description": "An admin copied a worker command from the setup health popover.",
+      "since": "2026-10-18",
+      "source": "ui",
+      "properties": {
+        "target": {
+          "type": "string",
+          "required": true,
+          "enum": [
+            "compose",
+            "docker",
+            "kubernetes"
+          ]
+        },
+        "harness": {
+          "type": "string",
+          "required": true,
+          "enum": [
+            "claude",
+            "codex",
+            "pi",
+            "devin",
+            "claude-managed",
+            "opencode",
+            "acp",
+            "dsh",
+            "amp",
+            "cursor",
+            "grok"
+          ]
+        }
+      }
     }
   ]
 }

package/src/telemetry-contract/ranking/fixtures/valid/no-claim.json

@@ -0,0 +1,10 @@
+{
+  "v": 1,
+  "name": "Example Org",
+  "domain": "example.com",
+  "category": "other",
+  "subcategory": null,
+  "description": null,
+  "sourceCodeUrl": null,
+  "updatedAt": "2026-10-18T10:00:00Z"
+}

package/src/telemetry-contract/ranking/listing.v1.schema.json

@@ -5,7 +5,7 @@
   "description": "The telemetry_ranking listing, version 1. agent-swarm stores it stringified in the global swarm_config key telemetry_ranking and sends the same string as the listing property of ranking.opted_in. The string must not exceed 2048 bytes. The ingest also requires name to equal context.org_name and domain to equal context.org_website. Text fields are trimmed before their length is checked; lengths count UTF-16 code units, as JavaScript does.",
   "type": "object",
   "additionalProperties": false,
-  "required": ["v", "claim", "name", "domain", "category", "subcategory", "description", "sourceCodeUrl", "updatedAt"],
+  "required": ["v", "name", "domain", "category", "subcategory", "description", "sourceCodeUrl", "updatedAt"],
   "properties": {
     "v": {
       "const": 1,
@@ -14,7 +14,7 @@
     "claim": {
       "type": "string",
       "pattern": "^rk_[0-9a-f]{32}$",
-      "description": "Claim minted by the install. The ranking PR carries it, and the proxy binds it to the first install that sent it. Never served publicly."
+      "description": "Optional and ignored. agent-swarm v2.4.0 mints it for a ranking PR flow that no longer exists; the proxy still checks its pattern when present, but ranks from telemetry alone. Never served publicly."
     },
     "name": {
       "type": "string",