@standardagents/spec 0.39.1 → 0.40.1

package/dist/index.js

@@ -337,6 +337,38 @@ function defineAgent(options) {
   if (!["ai_human", "dual_ai"].includes(type)) {
     throw new Error(`Invalid type '${type}'. Must be one of: ai_human, dual_ai`);
   }
+  if (options.parentHooks !== void 0) {
+    if (!Array.isArray(options.parentHooks)) {
+      throw new Error("parentHooks must be an array");
+    }
+    if (type !== "dual_ai") {
+      throw new Error("parentHooks may only be declared by dual_ai agents");
+    }
+    if (!options.exposeAsTool) {
+      throw new Error("parentHooks requires exposeAsTool: true");
+    }
+    const seenParentHooks = /* @__PURE__ */ new Set();
+    for (const requirement of options.parentHooks) {
+      if (!requirement || typeof requirement !== "object") {
+        throw new Error("parentHooks entries must be objects");
+      }
+      if (!requirement.hook || typeof requirement.hook !== "string") {
+        throw new Error("parentHooks[].hook is required");
+      }
+      if (typeof requirement.reason !== "string" || !requirement.reason.trim()) {
+        throw new Error(`parentHooks reason is required for hook '${requirement.hook}'`);
+      }
+      if (requirement.stage !== void 0 && requirement.stage !== "before_parent" && requirement.stage !== "after_parent") {
+        throw new Error(
+          `Invalid parentHooks stage '${requirement.stage}' for hook '${requirement.hook}'`
+        );
+      }
+      if (seenParentHooks.has(requirement.hook)) {
+        throw new Error(`Duplicate parentHooks hook '${requirement.hook}'`);
+      }
+      seenParentHooks.add(requirement.hook);
+    }
+  }
   validateSessionBinding("sideA", "sessionStop");
   validateSessionBinding("sideA", "sessionFail");
   validateSessionBinding("sideA", "sessionStatus");