agent-relay-server 0.8.1 → 0.10.0

package/src/recipe-validator.ts

@@ -0,0 +1,85 @@
+import type { Recipe, RecipeAgent } from "./types";
+
+class RecipeValidationError extends Error {}
+
+export function validateRecipe(value: unknown): Recipe {
+  if (!isRecord(value)) throw new RecipeValidationError("recipe must be an object");
+  const name = requiredString(value.name, "name");
+  const description = requiredString(value.description, "description");
+  if (!Array.isArray(value.agents) || value.agents.length === 0) {
+    throw new RecipeValidationError("agents must be a non-empty array");
+  }
+  const agents = value.agents.map(validateAgent);
+  const roles = new Set<string>();
+  for (const agent of agents) {
+    if (roles.has(agent.role)) throw new RecipeValidationError(`duplicate recipe agent role: ${agent.role}`);
+    roles.add(agent.role);
+  }
+  return {
+    name,
+    description,
+    version: optionalString(value.version, "version"),
+    author: optionalString(value.author, "author"),
+    agents,
+    workflow: isRecord(value.workflow) ? {
+      trigger: optionalString(value.workflow.trigger, "workflow.trigger"),
+      fanOut: value.workflow.fanOut === "first" ? "first" : value.workflow.fanOut === "all" ? "all" : undefined,
+      collect: optionalString(value.workflow.collect, "workflow.collect"),
+      routing: undefined,
+    } : undefined,
+    lifecycle: isRecord(value.lifecycle) ? {
+      mode: value.lifecycle.mode === "persistent" ? "persistent" : "ephemeral",
+      idleTimeoutMs: optionalPositiveInteger(value.lifecycle.idleTimeoutMs, "lifecycle.idleTimeoutMs"),
+    } : undefined,
+  };
+}
+
+function validateAgent(value: unknown): RecipeAgent {
+  if (!isRecord(value)) throw new RecipeValidationError("agent must be an object");
+  const provider = value.provider;
+  if (provider !== "claude" && provider !== "codex") throw new RecipeValidationError("agent.provider must be claude or codex");
+  const capabilities = stringArray(value.capabilities, "agent.capabilities");
+  if (capabilities.length === 0) throw new RecipeValidationError("agent.capabilities must not be empty");
+  const approvalMode = value.approvalMode;
+  if (approvalMode !== undefined && approvalMode !== "open" && approvalMode !== "guarded" && approvalMode !== "read-only") {
+    throw new RecipeValidationError("agent.approvalMode must be open, guarded, or read-only");
+  }
+  return {
+    role: requiredString(value.role, "agent.role"),
+    provider,
+    count: optionalPositiveInteger(value.count, "agent.count"),
+    capabilities,
+    label: optionalString(value.label, "agent.label"),
+    tags: value.tags === undefined ? undefined : stringArray(value.tags, "agent.tags"),
+    approvalMode,
+    prompt: optionalString(value.prompt, "agent.prompt"),
+    model: optionalString(value.model, "agent.model"),
+    env: isRecord(value.env) ? Object.fromEntries(Object.entries(value.env).filter((entry): entry is [string, string] => typeof entry[1] === "string")) : undefined,
+  };
+}
+
+function requiredString(value: unknown, field: string): string {
+  if (typeof value !== "string" || !value.trim()) throw new RecipeValidationError(`${field} required`);
+  return value.trim();
+}
+
+function optionalString(value: unknown, field: string): string | undefined {
+  if (value === undefined || value === null) return undefined;
+  if (typeof value !== "string") throw new RecipeValidationError(`${field} must be a string`);
+  return value.trim() || undefined;
+}
+
+function stringArray(value: unknown, field: string): string[] {
+  if (!Array.isArray(value) || value.some((item) => typeof item !== "string")) throw new RecipeValidationError(`${field} must be an array of strings`);
+  return value.map((item) => item.trim()).filter(Boolean);
+}
+
+function optionalPositiveInteger(value: unknown, field: string): number | undefined {
+  if (value === undefined || value === null) return undefined;
+  if (typeof value !== "number" || !Number.isSafeInteger(value) || value <= 0) throw new RecipeValidationError(`${field} must be a positive integer`);
+  return value;
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}