@app-vitals/agent-runtime 0.13.0 → 0.13.2

package/cutover-validate.integration.test.ts

@@ -42,6 +42,7 @@ function makeCron(id: string): AgentCronJob {
 
 function makeConfig(env: Record<string, string>): AgentConfigResponse {
   return {
+    specialty: "coding",
     env,
     allowedTools: [],
     plugins: [],

package/entrypoint.integration.test.ts

@@ -18,6 +18,7 @@ import { RecordedShipwrightConfigClient } from "./shipwright-config-client.ts";
 // ─── Test fixtures ─────────────────────────────────────────────────────────────
 
 const SAMPLE_CONFIG: AgentConfigResponse = {
+  specialty: "coding",
   env: {
     ANTHROPIC_MODEL: "claude-sonnet-4-6",
     CUSTOM_VAR: "custom-value",
@@ -139,18 +140,18 @@ describe("runEntrypoint — happy path", () => {
   it("exports the specialty to the server process when the config carries one (ARD-6.1)", async () => {
     const configClient = new RecordedShipwrightConfigClient({
       ...SAMPLE_CONFIG,
-      typeName: "specialist",
+      specialty: "specialist",
     });
     const { deps, appliedEnv } = makeDeps(configClient);
     await runEntrypoint(deps);
     expect(appliedEnv.SHIPWRIGHT_AGENT_TYPE).toBe("specialist");
   });
 
-  it("does not set SHIPWRIGHT_AGENT_TYPE when the config has no typeName (ARD-6.1)", async () => {
+  it("exports the default specialty from the config bundle (AGR-6.3: specialty is required)", async () => {
     const configClient = new RecordedShipwrightConfigClient(SAMPLE_CONFIG);
     const { deps, appliedEnv } = makeDeps(configClient);
     await runEntrypoint(deps);
-    expect(appliedEnv.SHIPWRIGHT_AGENT_TYPE).toBeUndefined();
+    expect(appliedEnv.SHIPWRIGHT_AGENT_TYPE).toBe("coding");
   });
 
   it("fetches config and applies env vars from the bundle", async () => {
@@ -272,6 +273,7 @@ describe("runEntrypoint — missing required vars", () => {
 describe("runEntrypoint — config with empty env", () => {
   it("handles config with no env vars gracefully", async () => {
     const emptyConfig: AgentConfigResponse = {
+      specialty: "coding",
       env: {},
       allowedTools: [],
       plugins: [],

package/entrypoint.ts

@@ -116,9 +116,7 @@ export async function runEntrypoint(deps: EntrypointDeps): Promise<void> {
     applyEnv(config.env);
     // ARD-6.1: hand the specialty to the server process (inherits our env) so
     // ensureAgentHome() can pick type-specific workspace templates.
-    if (config.typeName) {
-      applyEnv({ SHIPWRIGHT_AGENT_TYPE: config.typeName });
-    }
+    applyEnv({ SHIPWRIGHT_AGENT_TYPE: config.specialty });
 
     // Step 4: Symlink ~/.claude → $AGENT_HOME/dot-claude
     const dotClaudeTarget = join(agentHome, "dot-claude");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@app-vitals/agent-runtime",
-  "version": "0.13.0",
+  "version": "0.13.2",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/app-vitals/agent.git",
@@ -40,8 +40,8 @@
     "./workspace-paths": "./workspace-paths.ts"
   },
   "dependencies": {
-    "@app-vitals/agent-admin": "0.13.0",
-    "@app-vitals/agent-lib": "0.13.0",
+    "@app-vitals/agent-admin": "0.13.2",
+    "@app-vitals/agent-lib": "0.13.2",
     "@octokit/auth-app": "^8.2.0",
     "@sentry/bun": "^10.63.0",
     "@slack/bolt": "^5.0.0",

package/setup.ts

@@ -75,7 +75,7 @@ const REQUIRED_TEMPLATES: readonly string[] = [
 /**
  * Resolves the workspace template directory for a specialty (ARD-6.1).
  *
- * Reads `identity.templatesDir` from `<repoRoot>/specialties/<typeName>/manifest.yaml`
+ * Reads `identity.templatesDir` from `<repoRoot>/specialties/<specialty>/manifest.yaml`
  * (relative paths resolve against the repo root, matching how the manifests
  * spell them). Returns the built-in workspace/ dir for `coding`, an absent
  * type, and any type that does not resolve (no manifest, unparseable, or the
@@ -89,17 +89,17 @@ export function resolveTemplatesDir(
   env: Record<string, string | undefined> = process.env,
 ): string {
   const repoRoot = repoRootOverride ?? resolveShipwrightRepoRoot(env);
-  const typeName =
+  const specialty =
     requestedType ||
     env.SHIPWRIGHT_DEFAULT_AGENT_TYPE ||
     DEFAULT_SPECIALTY_NAME;
-  if (typeName === DEFAULT_SPECIALTY_NAME) {
+  if (specialty === DEFAULT_SPECIALTY_NAME) {
     return WORKSPACE_TEMPLATE_DIR;
   }
   try {
     const manifestPath = join(
       env.SHIPWRIGHT_SPECIALTIES_DIR || join(repoRoot, "specialties"),
-      typeName,
+      specialty,
       "manifest.yaml",
     );
     const manifest = Bun.YAML.parse(readFileSync(manifestPath, "utf8")) as {
@@ -128,7 +128,7 @@ export function resolveTemplatesDir(
     return dir;
   } catch (err) {
     warn(
-      `[setup] could not resolve workspace templates for specialty "${typeName}" ` +
+      `[setup] could not resolve workspace templates for specialty "${specialty}" ` +
         `(${(err as Error).message}) — falling back to "${DEFAULT_SPECIALTY_NAME}" templates`,
     );
     return WORKSPACE_TEMPLATE_DIR;
@@ -648,8 +648,8 @@ export function ensureAgentHome(
   home: string,
   // ARD-6.1: the entrypoint exports the agent's type (from the config
   // response) as SHIPWRIGHT_AGENT_TYPE before spawning this process.
-  typeName: string | undefined = process.env.SHIPWRIGHT_AGENT_TYPE,
-  templatesDir: string = resolveTemplatesDir(typeName),
+  specialty: string | undefined = process.env.SHIPWRIGHT_AGENT_TYPE,
+  templatesDir: string = resolveTemplatesDir(specialty),
 ): void {
   const workspaceDir = join(home, "workspace");
   const stateDir = join(workspaceDir, "state");

package/setup.unit.test.ts

@@ -267,6 +267,20 @@ describe("discoverBakedMarketplaces", () => {
 });
 
 describe("resolveTemplatesDir option resolution (AEP-1.2)", () => {
+  it("resolves the shipped specialist manifest to agent-types/specialist/templates/ with no warning (SAI-1.2)", async () => {
+    const { resolveTemplatesDir } = await import("./setup.ts");
+    const repoRoot = join(import.meta.dir, "..");
+    const warnings: string[] = [];
+    const dir = resolveTemplatesDir(
+      "specialist",
+      repoRoot,
+      (m) => warnings.push(m),
+      { SHIPWRIGHT_SPECIALTIES_DIR: join(repoRoot, "agent-types") },
+    );
+    expect(dir).toBe(join(repoRoot, "agent-types", "specialist", "templates"));
+    expect(warnings).toEqual([]);
+  });
+
   it("resolves an absent type to the built-in templates with no env set", async () => {
     const { resolveTemplatesDir } = await import("./setup.ts");
     const dir = resolveTemplatesDir(undefined, "/nonexistent", () => {}, {});

package/shipwright-runtime-client.integration.test.ts

@@ -22,6 +22,7 @@ const API_KEY = "test-bearer-key";
 const AGENT_ID = "agent-abc-123";
 
 const SAMPLE_CONFIG: AgentConfigResponse = {
+  specialty: "coding",
   env: { ANTHROPIC_MODEL: "claude-sonnet-4-6" },
   allowedTools: ["Read", "Bash"],
   plugins: [{ marketplace: "shipwright", plugin: "my-plugin" }],