@app-vitals/agent-admin 0.13.0 → 0.13.1

package/prisma/migrations/20261030000000_drop_agent_type_name/migration.sql

@@ -0,0 +1,8 @@
+-- AGR-6.3: REMOVE step of the typeName -> specialty rename.
+-- Backfill any row AGR-6.1/6.2 missed (specialty still NULL) from typeName,
+-- make specialty required (default 'coding', matching the old typeName
+-- default), then drop the legacy typeName column.
+UPDATE "Agent" SET "specialty" = "typeName" WHERE "specialty" IS NULL;
+ALTER TABLE "Agent" ALTER COLUMN "specialty" SET DEFAULT 'coding';
+ALTER TABLE "Agent" ALTER COLUMN "specialty" SET NOT NULL;
+ALTER TABLE "Agent" DROP COLUMN "typeName";

package/prisma/schema/schema.prisma

@@ -42,10 +42,9 @@ model Agent {
   reviewAuthorAllowlist  String[] @default([])
   patchAuthorAllowlist   String[] @default([])
   restrictSlackToMembers Boolean  @default(false)
-  typeName               String   @default("coding")
-  // AGR-6.1: typeName -> specialty rename (ADD step). Nullable; written
-  // alongside typeName, reads fall back to typeName when NULL.
-  specialty              String?
+  // The agent's Specialty name (manifest key). AGR-6.3 made it required and
+  // dropped the legacy typeName column.
+  specialty              String   @default("coding")
   // SSP-1.2: owning account. Nullable/additive — existing agents keep NULL.
   accountId              String?
   account                Account? @relation(fields: [accountId], references: [id], onDelete: Restrict)

package/src/account-lifecycle.integration.test.ts

@@ -86,7 +86,7 @@ describeOrSkip("account lifecycle (integration)", () => {
     trialExpiresAt: Date | null = null,
   ): Promise<string> {
     const a = await prisma.agent.create({
-      data: { name: "agent", typeName: "coding", accountId, trialExpiresAt },
+      data: { name: "agent", specialty: "coding", accountId, trialExpiresAt },
     });
     return a.id;
   }

package/src/account-trial-warning-sweeper.integration.test.ts

@@ -100,7 +100,7 @@ describeOrSkip("AccountTrialWarningSweeper (integration)", () => {
     name = "bot",
   ): Promise<string> {
     const a = await prisma.agent.create({
-      data: { name, typeName: "coding", accountId },
+      data: { name, specialty: "coding", accountId },
     });
     if (slack) {
       slackEnv.set(a.id, {

package/src/admin-local-agent.smoke.test.ts

@@ -247,7 +247,7 @@ function makeMockDeps(overrides?: Partial<AdminUIDeps>): AdminUIDeps {
         reviewAuthorAllowlist: [],
         patchAuthorAllowlist: [],
         restrictSlackToMembers: false,
-        typeName: TYPE,
+        specialty: TYPE,
         createdAt: new Date("2024-01-01"),
         updatedAt: new Date("2024-01-01"),
         missingRequiredEnv: [],
@@ -262,7 +262,7 @@ function makeMockDeps(overrides?: Partial<AdminUIDeps>): AdminUIDeps {
         reviewAuthorAllowlist: [],
         patchAuthorAllowlist: [],
         restrictSlackToMembers: false,
-        typeName: TYPE,
+        specialty: TYPE,
         createdAt: new Date("2024-01-01"),
         updatedAt: new Date("2024-01-01"),
         missingRequiredEnv: [],
@@ -276,7 +276,7 @@ function makeMockDeps(overrides?: Partial<AdminUIDeps>): AdminUIDeps {
         reviewAuthorAllowlist: [],
         patchAuthorAllowlist: [],
         restrictSlackToMembers: false,
-        typeName: TYPE,
+        specialty: TYPE,
         createdAt: new Date("2024-01-01"),
         updatedAt: new Date("2024-01-01"),
         missingRequiredEnv: [],
@@ -415,7 +415,7 @@ describe("admin UI — new local agent create flow", () => {
             reviewAuthorAllowlist: [],
             patchAuthorAllowlist: [],
             restrictSlackToMembers: false,
-            typeName: TYPE,
+            specialty: TYPE,
             createdAt: new Date("2024-01-01"),
             updatedAt: new Date("2024-01-01"),
             missingRequiredEnv: [],
@@ -476,7 +476,7 @@ describe("admin UI — new local agent create flow", () => {
           reviewAuthorAllowlist: [],
           patchAuthorAllowlist: [],
           restrictSlackToMembers: false,
-          typeName: TYPE,
+          specialty: TYPE,
           createdAt: new Date("2024-01-01"),
           updatedAt: new Date("2024-01-01"),
           missingRequiredEnv: [],
@@ -492,7 +492,7 @@ describe("admin UI — new local agent create flow", () => {
             reviewAuthorAllowlist: [],
             patchAuthorAllowlist: [],
             restrictSlackToMembers: false,
-            typeName: TYPE,
+            specialty: TYPE,
             createdAt: new Date("2024-01-01"),
             updatedAt: new Date("2024-01-01"),
             missingRequiredEnv: [],
@@ -661,7 +661,7 @@ describe("admin UI — new local agent create flow", () => {
             reviewAuthorAllowlist: [],
             patchAuthorAllowlist: [],
             restrictSlackToMembers: false,
-            typeName: TYPE,
+            specialty: TYPE,
             createdAt: new Date("2024-01-01"),
             updatedAt: new Date("2024-01-01"),
             missingRequiredEnv: [],
@@ -702,7 +702,7 @@ describe("admin UI — new local agent create flow", () => {
             reviewAuthorAllowlist: [],
             patchAuthorAllowlist: [],
             restrictSlackToMembers: false,
-            typeName: TYPE,
+            specialty: TYPE,
             createdAt: new Date("2024-01-01"),
             updatedAt: new Date("2024-01-01"),
             missingRequiredEnv: [],
@@ -744,7 +744,7 @@ describe("admin UI — new local agent create flow", () => {
           reviewAuthorAllowlist: [],
           patchAuthorAllowlist: [],
           restrictSlackToMembers: false,
-          typeName: TYPE,
+          specialty: TYPE,
           createdAt: new Date("2024-01-01"),
           updatedAt: new Date("2024-01-01"),
           missingRequiredEnv: [],
@@ -851,7 +851,7 @@ describe("admin UI — new local agent create flow", () => {
             reviewAuthorAllowlist: [],
             patchAuthorAllowlist: [],
             restrictSlackToMembers: false,
-            typeName: TYPE,
+            specialty: TYPE,
             createdAt: new Date("2024-01-01"),
             updatedAt: new Date("2024-01-01"),
             missingRequiredEnv: [],
@@ -1095,7 +1095,7 @@ describe("admin UI — new local agent create flow", () => {
           reviewAuthorAllowlist: [],
           patchAuthorAllowlist: [],
           restrictSlackToMembers: false,
-          typeName: TYPE,
+          specialty: TYPE,
           createdAt: new Date("2024-01-01"),
           updatedAt: new Date("2024-01-01"),
           missingRequiredEnv: [],
@@ -1537,7 +1537,7 @@ describe("admin UI — account users create / delete agents (SSP-4.2)", () => {
     expect(created).toHaveLength(1);
     expect(created[0]).toMatchObject({
       accountId: "acct-a",
-      typeName: TYPE,
+      specialty: TYPE,
     });
   });
 

package/src/admin-ui-pages.ts

@@ -80,7 +80,7 @@ export interface AgentDetail {
    */
   restrictSlackToMembers: boolean;
   /** The agent's type name (e.g. "coding"), resolved at creation time. */
-  typeName: string;
+  specialty: string;
   /**
    * Required env keys declared by the agent's type manifest with no
    * corresponding AgentEnv row yet — key names only, never values. Always
@@ -1911,7 +1911,7 @@ export function renderAgentDetailPage(
       <div>
         <a href="/admin/agents" style="font-size:13px;color:#6b7280;text-decoration:none">← Agents</a>
         <h1 class="page-title" style="margin-top:4px">${escapeHtml(agent.name)}</h1>
-        <span style="font-size:13px;color:#6b7280">Type: <span class="mono">${escapeHtml(agent.typeName)}</span></span>
+        <span style="font-size:13px;color:#6b7280">Type: <span class="mono">${escapeHtml(agent.specialty)}</span></span>
         ${agent.slackId ? `<span style="font-size:13px;color:#6b7280">Slack ID: <span class="mono">${escapeHtml(agent.slackId)}</span></span>` : ""}
       </div>
       ${

package/src/admin-ui-pages.unit.test.ts

@@ -47,7 +47,7 @@ const AGENT: AgentDetail = {
   authorAllowlist: [],
   patchAuthorAllowlist: [],
   restrictSlackToMembers: false,
-  typeName: "coding",
+  specialty: "coding",
   missingRequiredEnv: [],
   autoPostReviews: true,
   allowSelfReview: false,
@@ -638,7 +638,7 @@ describe("renderAgentDetailPage — overview", () => {
   test("XSS: specialty name is escaped", () => {
     const xssAgent: AgentDetail = {
       ...AGENT,
-      typeName: '<script>alert("xss")</script>',
+      specialty: '<script>alert("xss")</script>',
     };
     const html = renderAgentDetailPage(
       xssAgent,

package/src/admin-ui.fixtures.ts

@@ -336,7 +336,7 @@ export function makeMockDeps(
           name: "Test Agent",
           slackId: "U123456",
           selfHosted: false,
-          typeName: "coding",
+          specialty: "coding",
           createdAt: new Date("2024-01-01"),
           updatedAt: new Date("2024-01-01"),
         },
@@ -347,7 +347,7 @@ export function makeMockDeps(
           name: "Test Agent",
           slackId: "U123456",
           selfHosted: false,
-          typeName: "coding",
+          specialty: "coding",
           createdAt: new Date("2024-01-01"),
           updatedAt: new Date("2024-01-01"),
         },
@@ -358,7 +358,7 @@ export function makeMockDeps(
           name: "Test Agent",
           slackId: "U123456",
           selfHosted: false,
-          typeName: "coding",
+          specialty: "coding",
           createdAt: new Date("2024-01-01"),
           updatedAt: new Date("2024-01-01"),
         },
@@ -373,7 +373,7 @@ export function makeMockDeps(
         reviewAuthorAllowlist: [],
         patchAuthorAllowlist: [],
         restrictSlackToMembers: false,
-        typeName: "coding",
+        specialty: "coding",
         createdAt: new Date("2024-01-01"),
         updatedAt: new Date("2024-01-01"),
         missingRequiredEnv: [],
@@ -384,7 +384,7 @@ export function makeMockDeps(
         name: "Test Agent",
         slackId: "U123456",
         selfHosted: false,
-        typeName: "coding",
+        specialty: "coding",
         createdAt: new Date("2024-01-01"),
         updatedAt: new Date("2024-01-01"),
         repos: [],
@@ -398,7 +398,7 @@ export function makeMockDeps(
         name: "Test Agent",
         slackId: "U123456",
         selfHosted: false,
-        typeName: "coding",
+        specialty: "coding",
         createdAt: new Date("2024-01-01"),
         updatedAt: new Date("2024-01-01"),
         repos: [],

package/src/admin-ui.smoke.test.ts

@@ -1484,7 +1484,7 @@ describe("admin UI — authenticated pages", () => {
               name: "Managed Agent",
               slackId: "U0AALR8M69X",
               selfHosted: false,
-              typeName: TYPE,
+              specialty: TYPE,
               createdAt: new Date("2024-01-01"),
               updatedAt: new Date("2024-01-01"),
               repos: [],
@@ -1573,7 +1573,7 @@ describe("admin UI — authenticated pages", () => {
               name: "Self-Hosted Agent",
               slackId: null,
               selfHosted: true,
-              typeName: TYPE,
+              specialty: TYPE,
               createdAt: new Date("2024-01-01"),
               updatedAt: new Date("2024-01-01"),
               repos: [],
@@ -1603,7 +1603,7 @@ describe("admin UI — authenticated pages", () => {
               name: "Self-Hosted Agent",
               slackId: null,
               selfHosted: true,
-              typeName: TYPE,
+              specialty: TYPE,
               createdAt: new Date("2024-01-01"),
               updatedAt: new Date("2024-01-01"),
               repos: [],
@@ -1644,7 +1644,7 @@ describe("admin UI — authenticated pages", () => {
               name: "Self-Hosted Agent",
               slackId: null,
               selfHosted: true,
-              typeName: TYPE,
+              specialty: TYPE,
               createdAt: new Date("2024-01-01"),
               updatedAt: new Date("2024-01-01"),
               repos: [],
@@ -1703,7 +1703,7 @@ describe("admin UI — authenticated pages", () => {
               name: "Self-Hosted Agent",
               slackId: null,
               selfHosted: true,
-              typeName: TYPE,
+              specialty: TYPE,
               createdAt: new Date("2024-01-01"),
               updatedAt: new Date("2024-01-01"),
               repos: [],
@@ -2116,7 +2116,7 @@ describe("admin UI — owner and Anthropic identity section (PAI-2.5)", () => {
           name: "Test Agent",
           slackId: "U123456",
           selfHosted: false,
-          typeName: TYPE,
+          specialty: TYPE,
           createdAt: new Date("2024-01-01"),
           updatedAt: new Date("2024-01-01"),
           repos: [],
@@ -2249,7 +2249,7 @@ describe("admin UI — agent policy fields", () => {
             name: "Test Agent",
             slackId: "U123456",
             selfHosted: false,
-            typeName: TYPE,
+            specialty: TYPE,
             createdAt: new Date("2024-01-01"),
             updatedAt: new Date("2024-01-01"),
             repos: [],
@@ -2334,7 +2334,7 @@ describe("admin UI — agent policy fields", () => {
               name: "Test Agent",
               slackId: "U123456",
               selfHosted: false,
-              typeName: TYPE,
+              specialty: TYPE,
               createdAt: new Date("2024-01-01"),
               updatedAt: new Date("2024-01-01"),
               repos: [],
@@ -2379,7 +2379,7 @@ describe("admin UI — agent policy fields", () => {
               name: "Test Agent",
               slackId: "U123456",
               selfHosted: false,
-              typeName: TYPE,
+              specialty: TYPE,
               createdAt: new Date("2024-01-01"),
               updatedAt: new Date("2024-01-01"),
               repos: [],
@@ -2420,7 +2420,7 @@ describe("admin UI — agent policy fields", () => {
               name: "Test Agent",
               slackId: "U123456",
               selfHosted: false,
-              typeName: TYPE,
+              specialty: TYPE,
               createdAt: new Date("2024-01-01"),
               updatedAt: new Date("2024-01-01"),
               repos: [],
@@ -2473,7 +2473,7 @@ describe("admin UI — agent policy fields", () => {
               name: "Test Agent",
               slackId: "U123456",
               selfHosted: false,
-              typeName: TYPE,
+              specialty: TYPE,
               createdAt: new Date("2024-01-01"),
               updatedAt: new Date("2024-01-01"),
               repos: [],
@@ -2560,7 +2560,7 @@ describe("admin UI — agent policy fields", () => {
               name: "Test Agent",
               slackId: "U123456",
               selfHosted: false,
-              typeName: TYPE,
+              specialty: TYPE,
               createdAt: new Date("2024-01-01"),
               updatedAt: new Date("2024-01-01"),
               repos: [],
@@ -2605,7 +2605,7 @@ describe("admin UI — agent policy fields", () => {
               name: "Test Agent",
               slackId: "U123456",
               selfHosted: false,
-              typeName: TYPE,
+              specialty: TYPE,
               createdAt: new Date("2024-01-01"),
               updatedAt: new Date("2024-01-01"),
               repos: [],
@@ -2650,7 +2650,7 @@ describe("admin UI — agent policy fields", () => {
               name: "Test Agent",
               slackId: "U123456",
               selfHosted: false,
-              typeName: TYPE,
+              specialty: TYPE,
               createdAt: new Date("2024-01-01"),
               updatedAt: new Date("2024-01-01"),
               repos: [],
@@ -2962,7 +2962,7 @@ describe("admin UI — member access control", () => {
             name: "My Agent",
             slackId: "U1",
             selfHosted: false,
-            typeName: TYPE,
+            specialty: TYPE,
             createdAt: new Date("2024-01-01"),
             updatedAt: new Date("2024-01-01"),
           },
@@ -2971,7 +2971,7 @@ describe("admin UI — member access control", () => {
             name: "Other Agent",
             slackId: "U2",
             selfHosted: false,
-            typeName: TYPE,
+            specialty: TYPE,
             createdAt: new Date("2024-01-01"),
             updatedAt: new Date("2024-01-01"),
           },
@@ -2983,7 +2983,7 @@ describe("admin UI — member access control", () => {
               name: "My Agent",
               slackId: "U1",
               selfHosted: false,
-              typeName: TYPE,
+              specialty: TYPE,
               createdAt: new Date("2024-01-01"),
               updatedAt: new Date("2024-01-01"),
             },
@@ -2992,7 +2992,7 @@ describe("admin UI — member access control", () => {
               name: "Other Agent",
               slackId: "U2",
               selfHosted: false,
-              typeName: TYPE,
+              specialty: TYPE,
               createdAt: new Date("2024-01-01"),
               updatedAt: new Date("2024-01-01"),
             },
@@ -4146,7 +4146,7 @@ describe("admin UI — GET /admin/agents/:id/connect-slack/callback", () => {
       name: "Test Agent",
       slackId: null,
       selfHosted: false,
-      typeName: TYPE,
+      specialty: TYPE,
       createdAt: new Date("2024-01-01"),
       updatedAt: new Date("2024-01-01"),
       repos: [],
@@ -5290,7 +5290,7 @@ describe("admin UI — create agent with author allowlist", () => {
           name: "Test Agent",
           slackId: null,
           selfHosted: true,
-          typeName: TYPE,
+          specialty: TYPE,
           createdAt: new Date("2024-01-01"),
           updatedAt: new Date("2024-01-01"),
           repos: [],
@@ -5486,7 +5486,7 @@ describe("admin UI — create agent with patch author allowlist", () => {
           name: "Test Agent",
           slackId: null,
           selfHosted: true,
-          typeName: TYPE,
+          specialty: TYPE,
           createdAt: new Date("2024-01-01"),
           updatedAt: new Date("2024-01-01"),
           repos: [],
@@ -5865,7 +5865,7 @@ describe("admin UI — repos mutation routes", () => {
         name: "Test Agent",
         slackId: "U123456",
         selfHosted: false,
-        typeName: TYPE,
+        specialty: TYPE,
         createdAt: new Date("2024-01-01"),
         updatedAt: new Date("2024-01-01"),
         repos: ["my-org/my-repo"],
@@ -5881,7 +5881,7 @@ describe("admin UI — repos mutation routes", () => {
           name: "Test Agent",
           slackId: "U123456",
           selfHosted: false,
-          typeName: TYPE,
+          specialty: TYPE,
           createdAt: new Date("2024-01-01"),
           updatedAt: new Date("2024-01-01"),
           repos: capturedRepos ?? [],
@@ -6026,7 +6026,7 @@ describe("admin UI — author allowlist mutation routes", () => {
         name: "Test Agent",
         slackId: "U123456",
         selfHosted: false,
-        typeName: TYPE,
+        specialty: TYPE,
         createdAt: new Date("2024-01-01"),
         updatedAt: new Date("2024-01-01"),
         repos: [],
@@ -6045,7 +6045,7 @@ describe("admin UI — author allowlist mutation routes", () => {
           name: "Test Agent",
           slackId: "U123456",
           selfHosted: false,
-          typeName: TYPE,
+          specialty: TYPE,
           createdAt: new Date("2024-01-01"),
           updatedAt: new Date("2024-01-01"),
           repos: [],
@@ -6087,7 +6087,7 @@ describe("admin UI — author allowlist mutation routes", () => {
         name: "Test Agent",
         slackId: "U123456",
         selfHosted: false,
-        typeName: TYPE,
+        specialty: TYPE,
         createdAt: new Date("2024-01-01"),
         updatedAt: new Date("2024-01-01"),
         repos: [],
@@ -6103,7 +6103,7 @@ describe("admin UI — author allowlist mutation routes", () => {
           name: "Test Agent",
           slackId: "U123456",
           selfHosted: false,
-          typeName: TYPE,
+          specialty: TYPE,
           createdAt: new Date("2024-01-01"),
           updatedAt: new Date("2024-01-01"),
           repos: [],
@@ -6284,7 +6284,7 @@ describe("admin UI — patch author allowlist mutation routes", () => {
         name: "Test Agent",
         slackId: "U123456",
         selfHosted: false,
-        typeName: TYPE,
+        specialty: TYPE,
         createdAt: new Date("2024-01-01"),
         updatedAt: new Date("2024-01-01"),
         repos: [],
@@ -6303,7 +6303,7 @@ describe("admin UI — patch author allowlist mutation routes", () => {
           name: "Test Agent",
           slackId: "U123456",
           selfHosted: false,
-          typeName: TYPE,
+          specialty: TYPE,
           createdAt: new Date("2024-01-01"),
           updatedAt: new Date("2024-01-01"),
           repos: [],
@@ -6345,7 +6345,7 @@ describe("admin UI — patch author allowlist mutation routes", () => {
         name: "Test Agent",
         slackId: "U123456",
         selfHosted: false,
-        typeName: TYPE,
+        specialty: TYPE,
         createdAt: new Date("2024-01-01"),
         updatedAt: new Date("2024-01-01"),
         repos: [],
@@ -6361,7 +6361,7 @@ describe("admin UI — patch author allowlist mutation routes", () => {
           name: "Test Agent",
           slackId: "U123456",
           selfHosted: false,
-          typeName: TYPE,
+          specialty: TYPE,
           createdAt: new Date("2024-01-01"),
           updatedAt: new Date("2024-01-01"),
           repos: [],
@@ -6417,7 +6417,7 @@ describe("admin UI — patch author allowlist mutation routes", () => {
         name: "Test Agent",
         slackId: "U123456",
         selfHosted: false,
-        typeName: TYPE,
+        specialty: TYPE,
         createdAt: new Date("2024-01-01"),
         updatedAt: new Date("2024-01-01"),
         repos: [],
@@ -6433,7 +6433,7 @@ describe("admin UI — patch author allowlist mutation routes", () => {
           name: "Test Agent",
           slackId: "U123456",
           selfHosted: false,
-          typeName: TYPE,
+          specialty: TYPE,
           createdAt: new Date("2024-01-01"),
           updatedAt: new Date("2024-01-01"),
           repos: [],
@@ -6527,7 +6527,7 @@ describe("admin UI — Slack access settings route (restrictSlackToMembers)", ()
         name: "Test Agent",
         slackId: "U123456",
         selfHosted: false,
-        typeName: TYPE,
+        specialty: TYPE,
         createdAt: new Date("2024-01-01"),
         updatedAt: new Date("2024-01-01"),
         repos: [],
@@ -6569,7 +6569,7 @@ describe("admin UI — Slack access settings route (restrictSlackToMembers)", ()
         name: "Test Agent",
         slackId: "U123456",
         selfHosted: false,
-        typeName: TYPE,
+        specialty: TYPE,
         createdAt: new Date("2024-01-01"),
         updatedAt: new Date("2024-01-01"),
         repos: [],
@@ -6866,7 +6866,7 @@ describe("admin UI — Okta-authenticated access control", () => {
             name: "My Okta Agent",
             slackId: "U1",
             selfHosted: false,
-            typeName: TYPE,
+            specialty: TYPE,
             createdAt: new Date("2024-01-01"),
             updatedAt: new Date("2024-01-01"),
           },
@@ -6875,7 +6875,7 @@ describe("admin UI — Okta-authenticated access control", () => {
             name: "Other Okta Agent",
             slackId: "U2",
             selfHosted: false,
-            typeName: TYPE,
+            specialty: TYPE,
             createdAt: new Date("2024-01-01"),
             updatedAt: new Date("2024-01-01"),
           },
@@ -6887,7 +6887,7 @@ describe("admin UI — Okta-authenticated access control", () => {
               name: "My Okta Agent",
               slackId: "U1",
               selfHosted: false,
-              typeName: TYPE,
+              specialty: TYPE,
               createdAt: new Date("2024-01-01"),
               updatedAt: new Date("2024-01-01"),
             },
@@ -6896,7 +6896,7 @@ describe("admin UI — Okta-authenticated access control", () => {
               name: "Other Okta Agent",
               slackId: "U2",
               selfHosted: false,
-              typeName: TYPE,
+              specialty: TYPE,
               createdAt: new Date("2024-01-01"),
               updatedAt: new Date("2024-01-01"),
             },

package/src/admin-ui.ts

@@ -346,7 +346,7 @@ export interface AdminUIDeps {
   /** WIF-2.1: Anthropic federation is enabled; defaults to false. */
   anthropicFederationEnabled?: boolean;
   /**
-   * Resolves an agent's typeName to its parsed Specialty manifest and lists
+   * Resolves an agent's specialty to its parsed Specialty manifest and lists
    * the registry's discoverable types (for the new-specialty picker).
    * Defaults to a disk-backed SpecialtyRegistry, matching the DI pattern
    * already used by agents-api.ts's AdminDeps.
@@ -1449,7 +1449,7 @@ export function createAdminUIApp(deps: AdminUIDeps): Hono<AdminUIEnv> {
       return new Response("Forbidden", { status: 403 });
     }
     let name: string | undefined;
-    let typeName: string | undefined;
+    let specialty: string | undefined;
     let reposRaw: string | undefined;
     let authorAllowlistRaw: string | undefined;
     let patchAuthorAllowlistRaw: string | undefined;
@@ -1470,7 +1470,7 @@ export function createAdminUIApp(deps: AdminUIDeps): Hono<AdminUIEnv> {
     try {
       const formData = await c.req.formData();
       name = formData.get("name")?.toString()?.trim();
-      typeName = formData.get("type")?.toString()?.trim();
+      specialty = formData.get("type")?.toString()?.trim();
       reposRaw = formData.get("repos")?.toString()?.trim();
       authorAllowlistRaw = formData.get("authorAllowlist")?.toString()?.trim();
       patchAuthorAllowlistRaw = formData
@@ -1509,7 +1509,7 @@ export function createAdminUIApp(deps: AdminUIDeps): Hono<AdminUIEnv> {
     const connectSlack = connectSlackRaw === "true";
     // SSP-4.2: account users always create "coding" agents in their own
     // account — any submitted type/accountId is ignored.
-    if (accountId !== null) typeName = getSelfServeSpecialty();
+    if (accountId !== null) specialty = getSelfServeSpecialty();
     // Absent/unrecognized runtime means self-hosted — the historical behavior
     // of this form. createAgent() below re-derives this same value itself
     // (it owns the runtime/provisioning validation); it's recomputed here
@@ -1518,7 +1518,7 @@ export function createAdminUIApp(deps: AdminUIDeps): Hono<AdminUIEnv> {
     // whether this agent is in-cluster.
     const inCluster = runtime === "in-cluster";
 
-    // APA-1.1: the entire create-agent sequence (validate name/typeName,
+    // APA-1.1: the entire create-agent sequence (validate name/specialty,
     // create the Agent row, seed AgentTool/AgentPlugin from the type
     // manifest, attach repos/allowlists/members, patch Claude credentials,
     // provision Kubernetes when requested, best-effort reconcile system
@@ -1561,7 +1561,7 @@ export function createAdminUIApp(deps: AdminUIDeps): Hono<AdminUIEnv> {
       },
       {
         name,
-        typeName,
+        specialty,
         runtime,
         reposRaw,
         authorAllowlistRaw,
@@ -1736,7 +1736,7 @@ export function createAdminUIApp(deps: AdminUIDeps): Hono<AdminUIEnv> {
       authorAllowlist: agent.reviewAuthorAllowlist,
       patchAuthorAllowlist: agent.patchAuthorAllowlist,
       restrictSlackToMembers: agent.restrictSlackToMembers,
-      typeName: agent.typeName,
+      specialty: agent.specialty,
       missingRequiredEnv: agent.missingRequiredEnv,
       autoPostReviews: agent.autoPostReviews ?? true,
       allowSelfReview: agent.allowSelfReview ?? false,
@@ -2425,7 +2425,7 @@ export function createAdminUIApp(deps: AdminUIDeps): Hono<AdminUIEnv> {
       authorAllowlist: agent.reviewAuthorAllowlist,
       patchAuthorAllowlist: agent.patchAuthorAllowlist,
       restrictSlackToMembers: agent.restrictSlackToMembers,
-      typeName: agent.typeName,
+      specialty: agent.specialty,
       missingRequiredEnv: agent.missingRequiredEnv,
       autoPostReviews: agent.autoPostReviews ?? true,
       allowSelfReview: agent.allowSelfReview ?? false,