@app-vitals/agent-lib 0.16.0 → 0.16.2

package/default-specialty.ts

@@ -0,0 +1,38 @@
+/**
+ * lib/default-specialty.ts
+ *
+ * The single source of truth for the platform's default agent type and the
+ * directory its type definitions are loaded from. Shared by admin's
+ * SpecialtyRegistry / account-agent-create and runtime's resolveTemplatesDir so
+ * they can never disagree.
+ *
+ * Defaults are the platform's own: the `specialist` type under the shipped
+ * `agent-types/` directory (present in the platform image at /app/agent-types).
+ * SHIPWRIGHT_DEFAULT_AGENT_TYPE and SHIPWRIGHT_SPECIALTIES_DIR override them.
+ */
+
+import { join } from "node:path";
+
+/** The universal fallback type, shipped under agent-types/. */
+export const DEFAULT_SPECIALTY_NAME = "specialist";
+
+/** The shipped agent-types/ directory (lib/ and agent-types/ are siblings). */
+export const SHIPPED_AGENT_TYPES_DIR = join(
+  import.meta.dir,
+  "..",
+  "agent-types",
+);
+
+/** SHIPWRIGHT_DEFAULT_AGENT_TYPE when set and non-empty, else "specialist". */
+export function resolveDefaultSpecialtyName(
+  env: Record<string, string | undefined> = process.env,
+): string {
+  return env.SHIPWRIGHT_DEFAULT_AGENT_TYPE || DEFAULT_SPECIALTY_NAME;
+}
+
+/** SHIPWRIGHT_SPECIALTIES_DIR when set and non-empty, else the shipped agent-types/. */
+export function resolveSpecialtiesDir(
+  env: Record<string, string | undefined> = process.env,
+): string {
+  return env.SHIPWRIGHT_SPECIALTIES_DIR || SHIPPED_AGENT_TYPES_DIR;
+}

package/default-specialty.unit.test.ts

@@ -0,0 +1,44 @@
+import { describe, expect, it } from "bun:test";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import {
+  DEFAULT_SPECIALTY_NAME,
+  resolveDefaultSpecialtyName,
+  resolveSpecialtiesDir,
+  SHIPPED_AGENT_TYPES_DIR,
+} from "./default-specialty.ts";
+
+describe("default specialty resolution", () => {
+  it("defaults to the shipped specialist type", () => {
+    expect(DEFAULT_SPECIALTY_NAME).toBe("specialist");
+    expect(resolveDefaultSpecialtyName({})).toBe("specialist");
+  });
+
+  it("defaults the specialties dir to the shipped agent-types/ directory", () => {
+    expect(resolveSpecialtiesDir({})).toBe(SHIPPED_AGENT_TYPES_DIR);
+    expect(SHIPPED_AGENT_TYPES_DIR).toBe(
+      join(import.meta.dir, "..", "agent-types"),
+    );
+    expect(
+      existsSync(join(SHIPPED_AGENT_TYPES_DIR, "specialist", "manifest.yaml")),
+    ).toBe(true);
+  });
+
+  it("treats empty env values as unset", () => {
+    expect(
+      resolveDefaultSpecialtyName({ SHIPWRIGHT_DEFAULT_AGENT_TYPE: "" }),
+    ).toBe("specialist");
+    expect(resolveSpecialtiesDir({ SHIPWRIGHT_SPECIALTIES_DIR: "" })).toBe(
+      SHIPPED_AGENT_TYPES_DIR,
+    );
+  });
+
+  it("honours the env overrides", () => {
+    expect(
+      resolveDefaultSpecialtyName({ SHIPWRIGHT_DEFAULT_AGENT_TYPE: "base" }),
+    ).toBe("base");
+    expect(
+      resolveSpecialtiesDir({ SHIPWRIGHT_SPECIALTIES_DIR: "/tmp/types" }),
+    ).toBe("/tmp/types");
+  });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@app-vitals/agent-lib",
-  "version": "0.16.0",
+  "version": "0.16.2",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/app-vitals/agent.git",
@@ -31,6 +31,7 @@
     "./secret-env-vars": "./secret-env-vars.ts",
     "./default-account": "./default-account.ts",
     "./default-agent-env": "./default-agent-env.ts",
+    "./default-specialty": "./default-specialty.ts",
     "./sentry": "./sentry.ts",
     "./task-store-types": "./task-store-types.ts",
     "./web/*": "./web/*"