@app-vitals/agent-admin 0.16.2 → 1.0.0

package/e2e/agents-page.e2e.ts

@@ -304,7 +304,7 @@ test.describe("GET /admin/agents/new — type picker", () => {
     await expect(typeSelect).toHaveAttribute("required", "");
   });
 
-  test('the select lists "Coding Agent" (value coding)', async ({
+  test('the select lists the configured default type "coding"', async ({
     page,
     context,
   }) => {
@@ -313,7 +313,7 @@ test.describe("GET /admin/agents/new — type picker", () => {
       'select[name="type"] option[value="coding"]',
     );
     await expect(codingOption).toBeAttached();
-    await expect(codingOption).toHaveText("Coding Agent");
+    await expect(codingOption).toHaveText("coding");
   });
 });
 

package/openapi.json

@@ -3521,7 +3521,7 @@
     "/agents/{id}": {
       "get": {
         "summary": "Get an agent",
-        "description": "Admin-only. Returns the full agent record including `selfHosted`, `repos`, `reviewAuthorAllowlist`, `patchAuthorAllowlist`, `restrictSlackToMembers`, `specialty`, `accountId` (null for unassigned agents), and `missingRequiredEnv` — required env keys declared by the agent's type manifest with no corresponding AgentEnv row yet (informational only).",
+        "description": "Admin-only. Returns the full agent record including `selfHosted`, `repos`, `reviewAuthorAllowlist`, `patchAuthorAllowlist`, `restrictSlackToMembers`, `specialty`, `accountId` (null for unassigned agents), and `missingRequiredEnv` — required env keys declared by the agent's type with no corresponding AgentEnv row yet (informational only).",
         "parameters": [
           {
             "schema": {
@@ -3742,7 +3742,7 @@
       },
       "post": {
         "summary": "Create an agent",
-        "description": "Admin-only. Validates name/specialty, creates the Agent row, seeds AgentTool/AgentPlugin rows from the resolved type manifest, attaches repos/allowlists/members, patches Claude credentials, and provisions Kubernetes when `runtime` is \"in-cluster\" — the same createAgent() implementation (APA-1.1) the web UI form at /admin/agents/new uses. Transactional: on any failure zero rows persist, and this route never returns a partial-success 200. Returns the created agent in the same shape as GET /agents/:id.",
+        "description": "Admin-only. Validates name/specialty, creates the Agent row, seeds AgentTool/AgentPlugin rows from the resolved type, attaches repos/allowlists/members, patches Claude credentials, and provisions Kubernetes when `runtime` is \"in-cluster\" — the same createAgent() implementation (APA-1.1) the web UI form at /admin/agents/new uses. Transactional: on any failure zero rows persist, and this route never returns a partial-success 200. Returns the created agent in the same shape as GET /agents/:id.",
         "requestBody": {
           "content": {
             "application/json": {
@@ -4047,7 +4047,7 @@
     "/agents/{id}/crons/reconcile": {
       "post": {
         "summary": "Reconcile system crons",
-        "description": "Reconciles the agent's system crons against the cron list declared by its Specialty manifest. Runs in three passes within a single transaction: create-or-update matched-by-name system crons (preserving IDs so run history survives), link/unlink parent-child cron relationships, and delete orphaned system crons no longer in the manifest. Called automatically on agent startup; returns created/updated/deleted counts.",
+        "description": "Reconciles the agent's system crons against the cron list supplied by the AdminExtension for its specialty. Runs in three passes within a single transaction: create-or-update matched-by-name system crons (preserving IDs so run history survives), link/unlink parent-child cron relationships, and delete orphaned system crons no longer in the defaults. Called automatically on agent startup; returns created/updated/deleted counts.",
         "parameters": [
           {
             "schema": {

package/openapi.platform.json

@@ -3349,7 +3349,7 @@
     "/agents/{id}": {
       "get": {
         "summary": "Get an agent",
-        "description": "Admin-only. Returns the full agent record including `selfHosted`, `repos`, `reviewAuthorAllowlist`, `patchAuthorAllowlist`, `restrictSlackToMembers`, `specialty`, `accountId` (null for unassigned agents), and `missingRequiredEnv` — required env keys declared by the agent's type manifest with no corresponding AgentEnv row yet (informational only).",
+        "description": "Admin-only. Returns the full agent record including `selfHosted`, `repos`, `reviewAuthorAllowlist`, `patchAuthorAllowlist`, `restrictSlackToMembers`, `specialty`, `accountId` (null for unassigned agents), and `missingRequiredEnv` — required env keys declared by the agent's type with no corresponding AgentEnv row yet (informational only).",
         "parameters": [
           {
             "schema": {
@@ -3705,7 +3705,7 @@
       },
       "post": {
         "summary": "Create an agent",
-        "description": "Admin-only. Validates name/specialty, creates the Agent row, seeds AgentTool/AgentPlugin rows from the resolved type manifest, attaches repos/allowlists/members, patches Claude credentials, and provisions Kubernetes when `runtime` is \"in-cluster\" — the same createAgent() implementation (APA-1.1) the web UI form at /admin/agents/new uses. Transactional: on any failure zero rows persist, and this route never returns a partial-success 200. Returns the created agent in the same shape as GET /agents/:id.",
+        "description": "Admin-only. Validates name/specialty, creates the Agent row, seeds AgentTool/AgentPlugin rows from the resolved type, attaches repos/allowlists/members, patches Claude credentials, and provisions Kubernetes when `runtime` is \"in-cluster\" — the same createAgent() implementation (APA-1.1) the web UI form at /admin/agents/new uses. Transactional: on any failure zero rows persist, and this route never returns a partial-success 200. Returns the created agent in the same shape as GET /agents/:id.",
         "requestBody": {
           "content": {
             "application/json": {
@@ -4010,7 +4010,7 @@
     "/agents/{id}/crons/reconcile": {
       "post": {
         "summary": "Reconcile system crons",
-        "description": "Reconciles the agent's system crons against the cron list declared by its Specialty manifest. Runs in three passes within a single transaction: create-or-update matched-by-name system crons (preserving IDs so run history survives), link/unlink parent-child cron relationships, and delete orphaned system crons no longer in the manifest. Called automatically on agent startup; returns created/updated/deleted counts.",
+        "description": "Reconciles the agent's system crons against the cron list supplied by the AdminExtension for its specialty. Runs in three passes within a single transaction: create-or-update matched-by-name system crons (preserving IDs so run history survives), link/unlink parent-child cron relationships, and delete orphaned system crons no longer in the defaults. Called automatically on agent startup; returns created/updated/deleted counts.",
         "parameters": [
           {
             "schema": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@app-vitals/agent-admin",
-  "version": "0.16.2",
+  "version": "1.0.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/app-vitals/agent.git",
@@ -21,8 +21,7 @@
     "./main": "./src/main.ts",
     "./openapi-schemas": "./src/openapi-schemas.ts",
     "./prisma-client": "./src/prisma-client.ts",
-    "./specialty-manifest-loader": "./src/specialty-manifest-loader.ts",
-    "./specialty-registry": "./src/specialty-registry.ts",
+    "./specialty-types": "./src/specialty-types.ts",
     "./theme-tokens.json": "./src/theme-tokens.json",
     "./*": "./src/*.ts",
     "./prisma/client/*": "./prisma/client/*",
@@ -43,7 +42,7 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "0.135.0",
-    "@app-vitals/agent-lib": "0.16.2",
+    "@app-vitals/agent-lib": "1.0.0",
     "@hono/zod-openapi": "^1.0.0",
     "@prisma/adapter-pg": "^7.10.0",
     "@prisma/client": "^7.10.0",
@@ -52,7 +51,6 @@
     "@slack/web-api": "^8.1.0",
     "hono": "^4.13.1",
     "pg": "^8.16.3",
-    "yaml": "^2.9.0",
     "zod": "^4"
   },
   "devDependencies": {

package/src/account-agent-create.ts

@@ -9,7 +9,7 @@
  */
 
 import type { CallerScope } from "./caller-scope.ts";
-import { resolveDefaultSpecialtyName } from "./specialty-manifest-loader.ts";
+import { resolveDefaultSpecialtyName } from "./specialty-types.ts";
 
 /**
  * The only specialty account users may create: SHIPWRIGHT_SELF_SERVE_AGENT_TYPE

package/src/admin-boot.ts

@@ -74,9 +74,6 @@ import {
 import { createAdminUIApp } from "./admin-ui.ts";
 import { AgentAskService } from "./agent-ask.ts";
 import { parseAgentAskConfig } from "./agent-ask-config.ts";
-import { CronRunNowService } from "./cron-run-now.ts";
-import { parseCronRunNowConfig } from "./cron-run-now-config.ts";
-import { parsePodServiceAccountConfig } from "./pod-service-account-config.ts";
 import { AgentChatTokenService } from "./agent-chat-tokens.ts";
 import { AgentCronJobService } from "./agent-cron-jobs.ts";
 import { AgentCronRunStatsService } from "./agent-cron-run-stats.ts";
@@ -97,6 +94,8 @@ import {
 } from "./caller-scope.ts";
 import { parseChatCredentialConfig } from "./chat-credential-config.ts";
 import { HttpChatServiceProvisioningClient } from "./chat-service-provisioning-client.ts";
+import { CronRunNowService } from "./cron-run-now.ts";
+import { parseCronRunNowConfig } from "./cron-run-now-config.ts";
 import { CronRunTranscriptService } from "./cron-run-transcripts.ts";
 import { isDevAuthAllowed } from "./dev-auth-guard.ts";
 import { HttpGithubAppProvisioningClient } from "./github-app-provisioning-client.ts";
@@ -104,13 +103,14 @@ import { HttpGoogleAuthClient } from "./google-auth-client.ts";
 import { HttpChatClient } from "./http-chat-client.ts";
 import { HttpOktaAuthClient } from "./okta-auth-client.ts";
 import { mountPlatformDoc } from "./platform-doc-route.ts";
+import { parsePodServiceAccountConfig } from "./pod-service-account-config.ts";
 import { createAdminPrismaClient } from "./prisma-client.ts";
 import { isPushEnabled } from "./push-sender.ts";
 import { PushService } from "./push-service.ts";
 import { parseRepoAccessConfig } from "./repo-access-config.ts";
 import { parseSelfServeConfig } from "./self-serve-config.ts";
 import { HttpSlackProvisioningClient } from "./slack-provisioning-client.ts";
-import { SpecialtyRegistry } from "./specialty-manifest-loader.ts";
+import { SpecialtyTypes } from "./specialty-types.ts";
 import { runStartupPolicyReconcile } from "./startup-policy-reconcile.ts";
 import { makeTokenCrypto } from "./token-crypto.ts";
 import { parseTranscriptConfig } from "./transcript-config.ts";
@@ -181,10 +181,10 @@ export async function startAdmin(
     anthropicFederationEnabled,
   );
   // Extension-supplied specialty defaults (crons/tools/plugins), consulted by
-  // the cron reconcile and create-time seeding before the manifest.
+  // the cron reconcile and create-time seeding before the built-in type.
   const specialtyDefaults = collectSpecialtyDefaults(extensions);
   const specialtyRegistry = withExtensionAgentTypes(
-    new SpecialtyRegistry(),
+    new SpecialtyTypes(),
     extensions,
   );
   const agentCronJobService = new AgentCronJobService(

package/src/admin-extension.ts

@@ -28,12 +28,12 @@
  *                            serviceIntegrations it needs no context and is
  *                            collected before the services are built; the cron
  *                            reconcile and create-time seeding consult it
- *                            before the specialty manifest, which remains the
- *                            fallback when no extension returns anything
+ *                            before the built-in specialist type, which remains
+ *                            the fallback when no extension returns anything
  *   agentTypes()           — agent types this extension offers in the new-agent
  *                            picker and accepts in POST /admin/agents, for
- *                            types with no manifest on disk. Extension entries
- *                            win over a manifest of the same name; a type's
+ *                            types beyond the built-in specialist. Extension
+ *                            entries win over a built-in of the same name; a type's
  *                            crons still come from specialtyDefaults(name)
  *
  * openApi() is static (no context): scripts/generate-admin-spec.ts calls it to
@@ -68,9 +68,9 @@ import type {
   SpecialtyDefaultsResolver,
 } from "./specialty-defaults.ts";
 import type {
-  SpecialtyManifestResolver,
   SpecialtyOption,
-} from "./specialty-manifest-loader.ts";
+  SpecialtyTypeResolver,
+} from "./specialty-types.ts";
 
 /** The platform services an extension may build on. */
 export interface AdminPlatformServices {
@@ -187,9 +187,9 @@ export interface AdminExtension {
   name?: string;
   /** See the header: env-only, resolved before the provisioner is built. */
   serviceIntegrations?(env: NodeJS.ProcessEnv): ServiceIntegration[];
-  /** See the header: undefined means "no opinion" — the manifest applies. */
+  /** See the header: undefined means "no opinion" — the built-in type applies. */
   specialtyDefaults?(specialty: string): SpecialtyDefaults | undefined;
-  /** See the header: additive; merged over the manifest-discovered types. */
+  /** See the header: additive; merged over the built-in types. */
   agentTypes?(): SpecialtyOption[];
   services?(ctx: AdminExtensionContext): AdminExtensionServices;
   apiRoutes?(ctx: AdminExtensionContext): AdminRouteContribution[];
@@ -369,8 +369,9 @@ export function collectServiceIntegrations(
 
 /**
  * Builds the resolver the cron reconcile and create-time seeding consult
- * before the manifest. The first extension returning defaults wins; with none
- * registered (or none answering) it returns undefined and the manifest applies.
+ * before the built-in type. The first extension returning defaults wins; with none
+ * registered (or none answering) it returns undefined and the built-in type's
+ * tools floor applies.
  */
 export function collectSpecialtyDefaults(
   extensions: readonly AdminExtension[],
@@ -385,7 +386,7 @@ export function collectSpecialtyDefaults(
 }
 
 /**
- * Merges every extension's agentTypes() over the manifest-discovered `base`
+ * Merges every extension's agentTypes() over the built-in `base`
  * list. Order is base first, then new extension names; on a name collision the
  * extension's entry replaces the base entry in place.
  */
@@ -406,12 +407,12 @@ export function mergeAgentTypes(
  * the wrapped registry behaves exactly like `registry`.
  */
 export function withExtensionAgentTypes(
-  registry: SpecialtyManifestResolver,
+  registry: SpecialtyTypeResolver,
   extensions: readonly AdminExtension[],
-): SpecialtyManifestResolver {
+): SpecialtyTypeResolver {
   return {
-    getManifest: (specialty) => registry.getManifest(specialty),
-    tryGetManifest: (specialty) => registry.tryGetManifest(specialty),
+    getType: (specialty) => registry.getType(specialty),
+    tryGetType: (specialty) => registry.tryGetType(specialty),
     listTypes: () => mergeAgentTypes(registry.listTypes(), extensions),
     hasExtensionType: (specialty) =>
       mergeAgentTypes([], extensions).some((type) => type.name === specialty),

package/src/admin-extension.unit.test.ts

@@ -591,10 +591,10 @@ describe("mergeAgentTypes", () => {
 
 describe("withExtensionAgentTypes", () => {
   const registry = {
-    getManifest: () => {
+    getType: () => {
       throw new Error("unused");
     },
-    tryGetManifest: () => undefined,
+    tryGetType: () => undefined,
     listTypes: () => [{ name: "specialist", displayName: "Specialist" }],
   };
 

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

@@ -20,15 +20,18 @@ import type {
   AdminUISlackClient,
 } from "./admin-ui.ts";
 import { createAdminUIApp } from "./admin-ui.ts";
-import { SpecialtyRegistry } from "./specialty-manifest-loader.ts";
 import type { GoogleAuthClient } from "./google-auth-client.ts";
+import {
+  resolveDefaultSpecialtyName,
+  SpecialtyTypes,
+} from "./specialty-types.ts";
 
 // The configured default specialty (the fixture under the platform test run,
 // "coding" in the monorepo).
-const TYPE_META = new SpecialtyRegistry().getManifest(
-  process.env.SHIPWRIGHT_DEFAULT_AGENT_TYPE || "coding",
-).metadata;
-const TYPE = TYPE_META.name;
+const TYPE = resolveDefaultSpecialtyName();
+const TYPE_META = new SpecialtyTypes()
+  .listTypes()
+  .find((t) => t.name === TYPE) as { name: string; displayName: string };
 
 // ─── Constants ────────────────────────────────────────────────────────────────
 

package/src/admin-ui-pages.ts

@@ -28,7 +28,7 @@ import type {
   ThreadStats,
 } from "./http-chat-client.ts";
 import { renderPushToggle } from "./push-toggle.ts";
-import type { SpecialtyOption } from "./specialty-manifest-loader.ts";
+import type { SpecialtyOption } from "./specialty-types.ts";
 
 // ─── Helpers ──────────────────────────────────────────────────────────────────
 
@@ -83,7 +83,7 @@ export interface AgentDetail {
   /** The agent's type name (e.g. "specialist"), resolved at creation time. */
   specialty: string;
   /**
-   * Required env keys declared by the agent's type manifest with no
+   * Required env keys declared by the agent's type with no
    * corresponding AgentEnv row yet — key names only, never values. Always
    * present; purely informational (ATS-4.2), see renderAgentDetailPage's Env
    * Vars card.
@@ -2351,7 +2351,7 @@ const STALL_INDICATOR_CLASS = "chat-stall-indicator";
  * hard stop.
  */
 export const STALL_WARN_AFTER_MS = 120_000;
-// 65min — mirrors lib/claim-ttl.ts's DEFAULT_CLAIM_TTL_MS
+// 65min — mirrors DEFAULT_CLAIM_TTL_MS (Shipwright claim-ttl)
 // (DEFAULT_CLAUDE_TIMEOUT_MS 1hr + CLAIM_TTL_BUFFER_MS 5min). Inline JS can't
 // import the lib file, so the value is hardcoded here with this reference.
 export const ABSOLUTE_MAX_MS = 3_900_000;
@@ -2886,7 +2886,7 @@ export function renderChatThreadPage(
 
   // Stall-warning threshold — 120s in prod; e2e overrides to a tiny value.
   var STALL_WARN_AFTER_MS = ${stallWarnAfterMs};
-  // Hard ceiling: 65min, mirrors lib/claim-ttl.ts DEFAULT_CLAIM_TTL_MS
+  // Hard ceiling: 65min, mirrors Shipwright's DEFAULT_CLAIM_TTL_MS
   // (1hr DEFAULT_CLAUDE_TIMEOUT_MS + 5min CLAIM_TTL_BUFFER_MS). Only hard stop.
   var ABSOLUTE_MAX_MS = ${ABSOLUTE_MAX_MS};
 

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

@@ -12,8 +12,6 @@ import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { sign } from "hono/jwt";
 import { withExtensionAgentTypes } from "./admin-extension.ts";
-import { createAdminUIApp } from "./admin-ui.ts";
-import { SpecialtyRegistry } from "./specialty-manifest-loader.ts";
 import {
   AGENT_ID,
   CRON_ID,
@@ -28,16 +26,22 @@ import {
   TOKEN_ID,
   TOOL_ID,
 } from "./admin-ui.fixtures.ts";
+import { createAdminUIApp } from "./admin-ui.ts";
 import { AnthropicCredentialsBlockedError } from "./anthropic-credential-guard.ts";
 import type { PushService } from "./push-service.ts";
+import {
+  resolveDefaultSpecialtyName,
+  SPECIALIST_TYPE,
+  SpecialtyTypes,
+} from "./specialty-types.ts";
 
 // The specialty the create-agent flows use: the configured default type (the
 // platform test run points it at the fixture specialty; the monorepo falls
 // back to "coding").
-const TYPE_MANIFEST = new SpecialtyRegistry().getManifest(
-  process.env.SHIPWRIGHT_DEFAULT_AGENT_TYPE || "coding",
-);
-const TYPE = TYPE_MANIFEST.metadata.name;
+const TYPE = resolveDefaultSpecialtyName();
+const TYPE_RECORD = new SpecialtyTypes()
+  .listTypes()
+  .find((t) => t.name === TYPE) as { name: string; displayName: string };
 
 // ─── Auth redirect tests ──────────────────────────────────────────────────────
 
@@ -1290,7 +1294,7 @@ describe("admin UI — authenticated pages", () => {
       '<select id="type" name="type" class="form-input" required>',
     );
     expect(html).toContain(
-      `<option value="${TYPE}">${TYPE_MANIFEST.metadata.displayName}</option>`,
+      `<option value="${TYPE}">${TYPE_RECORD.displayName}</option>`,
     );
   });
 
@@ -5551,14 +5555,14 @@ describe("admin UI — create agent with patch author allowlist", () => {
   });
 });
 
-describe("admin UI — create agent seeds manifest tools and plugins", () => {
+describe("admin UI — create agent seeds type tools and extension plugins", () => {
   let cookie: string;
 
   beforeAll(async () => {
     cookie = await makeSessionCookie();
   });
 
-  it("POST /admin/agents with the default type seeds an AgentTool row for every manifest tool and an AgentPlugin row for every manifest plugin", async () => {
+  it("POST /admin/agents with the default type seeds an AgentTool row for every type tool and no AgentPlugin rows", async () => {
     const seededTools: string[] = [];
     const seededPlugins: string[] = [];
     const deps = makeMockDeps();
@@ -5596,28 +5600,13 @@ describe("admin UI — create agent seeds manifest tools and plugins", () => {
     });
     expect(res.status).toBe(302);
     expect(res.headers.get("Location")).toBe(`/admin/agents/${AGENT_ID}`);
-    expect(seededTools).toEqual(TYPE_MANIFEST.tools);
+    expect(seededTools).toEqual([...SPECIALIST_TYPE.tools]);
     expect(seededTools).toContain("Bash");
-    expect(seededPlugins).toEqual(TYPE_MANIFEST.plugins);
-  });
-
-  it("POST /admin/agents with the fixture specialty (AGR-1.9) seeds from its manifest and needs no product specialty", async () => {
-    const fixtureDir = [
-      join(
-        import.meta.dir,
-        "..",
-        "..",
-        "agent",
-        "src",
-        "fixtures",
-        "specialties",
-      ),
-      join(import.meta.dir, "..", "..", "runtime", "fixtures", "specialties"),
-    ].find((dir) => existsSync(dir)) as string;
-    const registry = new SpecialtyRegistry({
-      typesDir: fixtureDir,
-      defaultTypeName: "fixture",
-    });
+    expect(seededPlugins).toEqual([]);
+  });
+
+  it("POST /admin/agents with the configured default type (AGR-1.9) seeds the specialist floor and needs no product specialty", async () => {
+    const registry = new SpecialtyTypes({ defaultTypeName: "fixture" });
     const seededTools: string[] = [];
     const seededPlugins: string[] = [];
     const deps = makeMockDeps();
@@ -5649,7 +5638,7 @@ describe("admin UI — create agent seeds manifest tools and plugins", () => {
       headers: { Cookie: `admin_session=${cookie}` },
     });
     expect(await form.text()).toContain(
-      '<option value="fixture">Fixture Agent</option>',
+      '<option value="fixture">fixture</option>',
     );
     const res = await app.request("/admin/agents", {
       method: "POST",
@@ -5664,16 +5653,14 @@ describe("admin UI — create agent seeds manifest tools and plugins", () => {
     });
     expect(res.status).toBe(302);
     expect(res.headers.get("Location")).toBe(`/admin/agents/${AGENT_ID}`);
-    expect(seededTools).toEqual(registry.getManifest("fixture").tools);
-    expect(seededPlugins).toEqual(["fixture-plugin"]);
+    expect(seededTools).toEqual([...registry.getType("fixture").tools]);
+    expect(seededPlugins).toEqual([]);
   });
 
-  it("an extension-contributed type (ETP-1.2) shows in the picker and POST /admin/agents accepts it with no manifest", async () => {
-    const emptyDir = mkdtempSync(join(tmpdir(), "no-specialties-"));
-    const registry = withExtensionAgentTypes(
-      new SpecialtyRegistry({ typesDir: emptyDir }),
-      [{ agentTypes: () => [{ name: "coding", displayName: "Coding Agent" }] }],
-    );
+  it("an extension-contributed type (ETP-1.2) shows in the picker and POST /admin/agents accepts it", async () => {
+    const registry = withExtensionAgentTypes(new SpecialtyTypes(), [
+      { agentTypes: () => [{ name: "coding", displayName: "Coding Agent" }] },
+    ]);
     const deps = makeMockDeps();
     deps.specialtyRegistry = registry;
     const app = createAdminUIApp(deps);
@@ -5733,6 +5720,7 @@ describe("admin UI — create agent seeds manifest tools and plugins", () => {
   it("POST /admin/agents rolls back the agent and redirects with error when plugin seeding fails", async () => {
     let deletedId: string | undefined;
     const deps = makeMockDeps();
+    deps.specialtyDefaults = () => ({ plugins: ["ext-plugin"] });
     deps.agentPluginService = {
       ...deps.agentPluginService,
       add: async () => {

package/src/admin-ui.ts

@@ -74,11 +74,6 @@ import type { AgentPluginService } from "./agent-plugins.ts";
 import type { AgentProvisioner } from "./agent-provisioner.ts";
 import type { AgentTokenService } from "./agent-tokens.ts";
 import type { AgentToolService } from "./agent-tools.ts";
-import {
-  type SpecialtyManifestResolver,
-  SpecialtyRegistry,
-} from "./specialty-manifest-loader.ts";
-import type { SpecialtyDefaultsResolver } from "./specialty-defaults.ts";
 import type { AgentService } from "./agents.ts";
 import { createAgent, describeRepoNameCollision } from "./agents.ts";
 import { AnthropicCredentialsBlockedError } from "./anthropic-credential-guard.ts";
@@ -86,7 +81,6 @@ import {
   audioContentTypeForFilename,
   validateAttachment,
 } from "./attachment-validation.ts";
-import { parseByteRange } from "./http-range.ts";
 import {
   type CallerScopeResolver,
   memberOnlyCallerScopeResolver,
@@ -105,6 +99,7 @@ import {
   filterSince,
   toPolledMessage,
 } from "./http-chat-client.ts";
+import { parseByteRange } from "./http-range.ts";
 import type { OktaAuthClient } from "./okta-auth-client.ts";
 import type { PrismaTransactionClient } from "./prisma-tx.ts";
 import type { PushService } from "./push-service.ts";
@@ -132,6 +127,11 @@ import {
   PROVISION_STATE_TTL_SECONDS,
   SlackProvisioningService,
 } from "./slack-provisioning-service.ts";
+import type { SpecialtyDefaultsResolver } from "./specialty-defaults.ts";
+import {
+  type SpecialtyTypeResolver,
+  SpecialtyTypes,
+} from "./specialty-types.ts";
 
 export type AdminUIEnv = { Variables: { userEmail: string; isAdmin: boolean } };
 
@@ -347,13 +347,13 @@ export interface AdminUIDeps {
   /** WIF-2.1: Anthropic federation is enabled; defaults to false. */
   anthropicFederationEnabled?: boolean;
   /**
-   * 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
+   * Resolves an agent's specialty to its type record and lists
+   * the registry's built-in types (for the new-specialty picker).
+   * Defaults to a disk-backed SpecialtyTypes, matching the DI pattern
    * already used by agents-api.ts's AdminDeps.
    */
-  specialtyRegistry?: SpecialtyManifestResolver;
-  /** Extension-supplied specialty defaults, consulted before the manifest. */
+  specialtyRegistry?: SpecialtyTypeResolver;
+  /** Extension-supplied specialty defaults, consulted before the built-in type. */
   specialtyDefaults?: SpecialtyDefaultsResolver;
   /**
    * Cleanup deps for the full delete-agent orchestration (POST
@@ -784,7 +784,7 @@ export function createAdminUIApp(deps: AdminUIDeps): Hono<AdminUIEnv> {
     accountOnboarding,
     accountCreatedNotifier,
     accountServices,
-    specialtyRegistry = new SpecialtyRegistry(),
+    specialtyRegistry = new SpecialtyTypes(),
     specialtyDefaults,
     callerScopeResolver = memberOnlyCallerScopeResolver(agentMemberService),
     serviceIntegrations,

package/src/agent-chat-tokens.smoke.test.ts

@@ -222,10 +222,10 @@ function makeMockDeps(opts?: {
       listByAgentId: async () => [],
     },
     specialtyRegistry: {
-      getManifest: () => {
+      getType: () => {
         throw new Error("not implemented");
       },
-      tryGetManifest: () => undefined,
+      tryGetType: () => undefined,
       listTypes: () => [],
     },
     agentChatTokenService: {

package/src/agent-cron-jobs.integration.test.ts

@@ -18,8 +18,14 @@ import {
 import { AgentCronJobService } from "./agent-cron-jobs.ts";
 import { NotFoundError, UnprocessableEntityError } from "./errors.ts";
 import { createAdminPrismaClient } from "./prisma-client.ts";
-import type { SpecialtyManifestResolver } from "./specialty-manifest-loader.ts";
-import type { SpecialtyManifest } from "./specialty-registry.ts";
+import type {
+  SpecialtyDefaultCron,
+  SpecialtyDefaultsResolver,
+} from "./specialty-defaults.ts";
+import {
+  SPECIALIST_TYPE,
+  type SpecialtyTypeResolver,
+} from "./specialty-types.ts";
 
 const TEST_DB = process.env.DATABASE_URL_ADMIN_TEST;
 
@@ -34,9 +40,7 @@ function makePrisma(): PrismaClient {
 // cron, covering every field reconcile maps into a row.
 const FIXTURE_TYPE = "fixture";
 
-type ManifestCron = SpecialtyManifest["crons"][number];
-
-const FIXTURE_CRONS: ManifestCron[] = [
+const FIXTURE_CRONS: SpecialtyDefaultCron[] = [
   {
     name: "fixture-loop",
     schedule: "*/30 * * * *",
@@ -70,23 +74,16 @@ const FIXTURE_CRONS: ManifestCron[] = [
   },
 ];
 
-const fixtureManifest = {
-  crons: FIXTURE_CRONS,
-} as unknown as SpecialtyManifest;
+/** The extension hook supplying FIXTURE_TYPE's crons. */
+const fixtureDefaults: SpecialtyDefaultsResolver = (specialty) =>
+  specialty === FIXTURE_TYPE ? { crons: FIXTURE_CRONS } : undefined;
 
 /** Resolves only FIXTURE_TYPE; every other type is unknown. */
-const fixtureResolver: SpecialtyManifestResolver = {
-  getManifest(specialty: string): SpecialtyManifest {
-    if (specialty !== FIXTURE_TYPE)
-      throw new Error(`no manifest: ${specialty}`);
-    return fixtureManifest;
-  },
-  tryGetManifest(specialty: string): SpecialtyManifest | undefined {
-    return specialty === FIXTURE_TYPE ? fixtureManifest : undefined;
-  },
-  listTypes() {
-    return [{ name: FIXTURE_TYPE, displayName: FIXTURE_TYPE }];
-  },
+const fixtureResolver: SpecialtyTypeResolver = {
+  getType: () => SPECIALIST_TYPE,
+  tryGetType: (specialty) =>
+    specialty === FIXTURE_TYPE ? SPECIALIST_TYPE : undefined,
+  listTypes: () => [{ name: FIXTURE_TYPE, displayName: FIXTURE_TYPE }],
 };
 
 async function createAgent(
@@ -109,7 +106,12 @@ describeOrSkip("AgentCronJobService (integration)", () => {
     await prisma.agentTool.deleteMany();
     await prisma.agentEnv.deleteMany();
     await prisma.agent.deleteMany();
-    service = new AgentCronJobService(prisma, undefined, fixtureResolver);
+    service = new AgentCronJobService(
+      prisma,
+      undefined,
+      fixtureResolver,
+      fixtureDefaults,
+    );
   });
 
   afterEach(async () => {